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 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.

ACEE_ptr

The name of a fullword containing the address of an area that contains a previously created ACEE. If the caller does not specify an ACEE, this area must contain binary zeros. The ACEE parameter is not specified by an ALET. This parameter must be in the primary address space.

ALET

The name of a word which must be in the primary address space and which contains the ALET for the following fields:

Principal_string_uuid
Cell_string_uuid
RACF_userid
RACF_class
Entity_name
Entity_length
Access_requested

Principal_string_uuid

The name of an area containing the string form of the client's DCE UUID. If the caller does not specify the client's DCE UUID, then the first character of the area must be a NULL byte. (That is, the first byte of the 36-byte area must contain X'00'.)

Cell_string_uuid

The name of an area containing the string form of the cell DCE UUID. The string form of the cell UUID, if supplied by the caller, must be 36 bytes long.

The Cell_string_uuid must be the name of a 36-byte area that contains one of the following:

The string form of the cell UUID
A null byte (X'00') as the first character of the 36-byte area. If the home cell UUID is not applicable and the caller wants to obtain cross linking information using only the DCE principal UUID, the caller must pass the Cell_string_uuid parameter with the first byte of this field containing a null byte of X'00'.

RACF_userid

The name of a 9-byte area, which consists of a 1-byte length field followed by up to eight characters. It must be specified in uppercase. If not specified, the length must equal zero.

RACF_class

The name of an 8-byte area containing the RACF class name of the resource (such as TAPEVOL). The class name must be

Left justified
Padded to the right with blanks
Specified in uppercase
Defined to RACF in the RACF class descriptor table.

Entity_name

The name of an area that contains the RACF entity or resource name (such as TAPE01). It must be specified in uppercase and should not contain generic characters.

Entity_length

The name of an area that contains the halfword length of the entity_name. The valid range of this parameter is 1 to 246 characters.

Access_requested

The requested access (READ, UPDATE, CONTROL, ALTER) to the resource, which is the name of a 1-byte area containing:

Requested access	Value
READ Access	X'02'
UPDATE Access	X'04'
CONTROL Access	X'08'
ALTER Access	X'80'