Guardian Programming Reference Summary for pTAL and TAL

Procedure Calls Summary (G-N)
Guardian Programming Reference Summary for pTAL and TAL—522631-001
6-9
GROUPMEMBER_GETNEXT_
Returns a user name or alias associated with a group ID. On successive calls, all user
names and aliases associated with a given group ID can be obtained.
GROUPNAMETOGROUPID
(Superseded by USER_GETINFO_) Returns the group ID associated with an existing
group name from the USERID file.
error := GROUPMEMBER_GETNEXT_ ( groupid
,member-name:member-maxlen
,member-curlen );
error, INT returned value
0 No error.
11 Record not in file. The specified group has no more members or 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 This procedure was called without specifying all parameters.
590 Bad parameter value. Either the value specified in member-curlen is greater than
the value specified in member-maxlen, the value specified in member-curlen is
not within the valid range, or the value specified in groupid is not within the valid
range.
groupid, INT(32):value input
member-name:member-maxlen, STRING .EXT:ref:*,INT:value input, output:input
member-curlen, INT .EXT:ref:1 input, output
CALL GROUPNAMETOGROUPID ( name-id );
name-id, INT:ref:4 input, output
< (CCL) The value of name-id is out of bounds, or an I/O error occurred when the
procedure accessed $SYSTEM.SYSTEM.USERID.
= (CCE) The designated group ID is returned.
> (CCG) The specified group name is undefined.