Guardian Procedure Calls Reference Manual

GROUPNAMETOGROUPID Procedure (Superseded by GROUP_GETINFO_
Procedure)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameter
Condition Code Settings
Example
Summary
NOTE: This procedure is supported for compatibility with previous software and should not be
used for new development. This procedure does not support file-sharing groups.
The GROUPNAMETOGROUPID procedure returns the group ID associated with an existing group
name from the USERID file.
Syntax for C Programmers
#include <cextdecs(GROUPNAMETOGROUPID)>
_cc_status GROUPNAMETOGROUPID ( short _near *name-id );
• The function value returned by GROUPNAMETOGROUPID, which indicates the condition
code, can be interpreted by _status_lt(), or _status_eq(), or _status_gt() (defined
in the file tal.h).
Syntax for TAL Programmers
CALL GROUPNAMETOGROUPID ( name-id ); ! i,o
Parameter
name-id
input, output
INT:ref:4
on input, name-id contains the group name to be converted (in place) to a group ID. The
group name is passed in the form:
name-id FOR 4 = group name (blank filled)
The group name must be input in uppercase.
On return, name-id contains the group ID associated with the group name in the form:
name-id.<8:15> = group ID {0:255}
Condition Code Settings
indicates that name-id is out of bounds, or that an I/O error occurred when the procedure accessed
the $SYSTEM.SYSTEM.USERID file.
< (CCL)
indicates that the designated group ID is returned.= (CCE)
indicates that the specified group name is undefined.> (CCG)
GROUPNAMETOGROUPID Procedure (Superseded by GROUP_GETINFO_ Procedure) 687