Guardian Procedure Calls Reference Manual

GROUPIDTOGROUPNAME 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 GROUPIDTOGROUPNAME procedure returns the group name associated with an existing
group ID from the USERID file.
Syntax for C Programmers
#include <cextdecs(GROUPIDTOGROUPNAME)>
_cc_status GROUPIDTOGROUPNAME ( short _near *id-name );
• The function value returned by GROUPIDTOGROUPNAME, 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
CALL GROUPIDTOGROUPNAME ( id-name ) ; ! i,o
Parameter
id-name
input, output
INT:ref:4
On input, contains the group ID to be converted to a group name. The group ID is passed in
the form:
id-name.<8:15> = group ID {0:255}
On return, contains the group name associated with the specified group ID in the form:
id-name FOR 4 = group name (blank-filled)
Condition Code Settings
indicates that a required parameter is missing, that a buffer is out of bounds, or that an I/O error
occurred when accessing the $SYSTEM.SYSTEM.USERID file.
< (CCL)
indicates that the designated group name is returned.= (CCE)
indicates that the specified group ID is undefined.> (CCG)
GROUPIDTOGROUPNAME Procedure (Superseded by GROUP_GETINFO_ Procedure) 683