Guardian Programming Reference Summary for pTAL and TAL

Procedure Calls Summary (G-N)
Guardian Programming Reference Summary for pTAL and TAL—522631-001
6-8
GROUP_GETNEXT_
Returns a group name and group ID. On successive calls, all group names and group IDs
can be obtained.
GROUPIDTOGROUPNAME
(Superseded by USER_GETINFO_) Returns the group name associated with an existing
group ID from the USERID file.
error := GROUP_GETINFO_ ( group-name:group-maxlen
,group-curlen
,[ groupid ] );
error, INT returned value
0No error.
11 Record not in file. There are no more groups, or the specified group name is undefined.
22 Parameter out of bounds. An input parameter is not within the valid range, or return
information does not fit into the length of the space provided, or an output parameter
overlays the stack marker that was created by calling this procedure.
29 Missing parameter. This procedure was called without specifying a required parameter.
590 Bad parameter value. The value specified in group-curlen is greater than the value
specified in group-maxlen.
group-name:group-maxlen, STRING .EXT:ref:*,
INT:value
input, output:input
group-curlen, INT .EXT:ref:1 input, output
groupid, INT(32) .EXT:ref:1 output
CALL GROUPIDTOGROUPNAME ( id-name );
id-name, INT:ref:4 input, output
< (CCL) required parameter is missing, a buffer is out of bounds, or an I/O error
occurred when accessing the $SYSTEM.SYSTEM.USERID file.
= (CCE) The designated group name is returned.
> (CCG) The specified group ID is undefined.