Parameters

Work_area

The name of a 1024-byte work area for SAF and RACF® usage. The work area must be in the primary address space.

ALET

The name of a word containing the ALET for the following parameter. Each parameter must have an ALET specified. Each ALET can be different. The words containing the ALETs must be in the primary address space.

SAF_return_code

The name of a fullword in which the SAF router returns the SAF return code.

RACF_return_code

The name of a fullword in which the service routine stores the return code.

RACF_reason_code

The name of a fullword in which the service routine stores the reason code.

Flag

The name of a word containing the lookup option:

X'00000000': search by z/OS UNIX group identifier (GID), return group name
X'00000001': search by group name, return GID
X'00000002': search by group name, return z/OS® UNIX group identifier (GID), but do not create a new GID even if BPX.UNIQUE.USER is defined.

GID

The name of a fullword for a z/OS UNIX group identifier (GID). The GID is either input or output in this word, depending on the flag parameter.

Group_name

The name of an 8-byte area for the group name. The group name is left-justified and padded with blanks and is either input or output in the area, depending on the flag parameter.