Parameters

Work_area

The name of a 1024-byte work area for SAF and RACF® use. 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.

Function_code

The name of a 1-byte area containing the function code:

X'01': get_key (retrieve current DCE key)
X'02': put_key (set DCE key)
X'03': get_ldap_pw (get the LDAP bind password from the PROXY segment)

RACF_entity

Formally called RACF_userid. The name of a 247-byte area, which consists of a 1-byte length field followed by up to 246 characters. This field is to contain the RACF entity for the password being set or retrieved.

For functions get_key and put_key, this field is the RACF user ID.

For function get_ldap_pw, this field is a LDAPBIND Class general resource profile name. Setting the length byte to x'00' indicates to retrieve the default LDAP bind password from the IRR.PROXY.DEFAULTS profile in the FACILITY Class.

Key_area

The name of an area containing the DCE key, preceded by a 2-byte length field.

Key_area_length

The name of a fullword that contains the length of the key_area.