Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (G)
Guardian Procedure Calls Reference Manual—522629-013
6-38
GROUP_GETNEXT_ Procedure
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.
Refer to the
Guardian Procedure Errors and Messages Manual for more
information on file-system error messages.
group-name:group-maxlen input, output:input
STRING .EXT:ref:*, INT:value
on input, if
group-curlen is not 0, group-name specifies a character string that
precedes the next
group-name to be returned. group-maxlen specifies the
length of the string variable
group-name in bytes. To obtain the first group name,
set
group-curlen to 0.
On output, this parameter returns the group name that follows the
group-name
specified as the input parameter.
The
group-name parameter is passed, and returned, in the form of a case-
sensitive string that is as many as 32 alphanumeric characters long.
group-curlen input, output
INT .EXT:ref:1
on input, contains the actual length of
group-name in bytes. To obtain the first
group name, set
group-curlen to 0. The default value is 0.
On output, this parameter contains the actual length of
group-name in bytes.
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.
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.