Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (G)
Guardian Procedure Calls Reference Manual—522629-013
6-45
GROUPNAMETOGROUPID Procedure
(Superseded by GROUP_GETINFO_ Procedure )
GROUPNAMETOGROUPID Procedure
(Superseded by GROUP_GETINFO_
Procedure )
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Example
Summary
The GROUPNAMETOGROUPID procedure returns the group ID associated with an
existing group name from the USERID file.
Syntax for C Programmers
•
The function value returned by GROUPNAMETOGROUPID, which indicates the
condition code, can be interpreted by
_status_lt(), _status_eq(), or
_status_gt() (defined in the file tal.h).
Syntax for TAL Programmers
Parameters
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)
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.
#include <cextdecs(GROUPNAMETOGROUPID)>
_cc_status GROUPNAMETOGROUPID ( short _near *name-id );
CALL GROUPNAMETOGROUPID ( name-id ); ! i,o