Guardian Procedure Calls Reference Manual

groupid
output
INT(32) .EXT:ref:1
returns the group ID corresponding to the returned group-name.
groupid is a value in the range 0 through 65535.
Returned Value
INT
A file-system error code that indicates the outcome of the call. Common errors returned are:
No error.0
Record not in file. There are no more groups, or the specified group name is undefined.11
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.
22
Missing parameter. This procedure was called without specifying a required parameter.29
Bad parameter value. The value specified in group-curlen is greater than the value specified in
group-maxlen.
590
For more information on file-system error codes, see the Guardian Procedure Errors and Messages
Manual.
Considerations
• Names are not returned in any particular order, and the order can change from one RVU to
the next.
• Naming rules in the Guardian environment are more restrictive than those in the OSS
environment.
Example
! obtain all group names
i := 0;
curlen := 0;
DO
error := GROUP_GETNEXT_ ( name:MAXLEN, curlen);
group^list[i] ’:=’ name for curlen BYTES;
I := i + 1;
UNTIL (error <> 0);
682 Guardian Procedure Calls (G)