XSFL gate, UNFLATTEN_ESM_UTOKEN function
The UNFLATTEN_ESM_UTOKEN function of the XSFL gate returns userid and groupid information associated with the external security manager's user token.
Input Parameters
- ESM_UTOKEN_PTR
- is a pointer to a security manager user pointer.
Output Parameters
- REASON
- The following values are returned when RESPONSE is DISASTER:
- ABEND
- ESM_ABENDED
- LOOP
- The following values are returned when RESPONSE is EXCEPTION:
- APPLID_NOTAUTH
- ENTRY_PORT_NOTAUTH
- ESM_INACTIVE
- ESM_TRANQUIL
- GETMAIN_FAILED
- GROUP_ACCESS_REVOKED
- SECLABEL_CHECK_FAILED
- SECURITY_INACTIVE
- UNKNOWN_ESM_RESPONSE
- USERID_NOT_DEFINED
- USERID_NOT_IN_GROUP
- USERID_REVOKED
- The following values are returned when RESPONSE is INVALID:
- INVALID_FLATTENED_BUFFER
- INVALID_FORMAT
- INVALID_FUNCTION
- CURRENT_GROUPID
- is the identifier, 1 through 10 alphanumeric characters, of the current RACF user group to which the userid (specified by the SECURITY_TOKEN value) is assigned.
- CURRENT_GROUPID_LENGTH
- is the 8-bit length of the GROUPID value.
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- USERID
- is the identifier of the user (a userid of 1 through 10 alphanumeric characters). the userid (specified by the SECURITY_TOKEN value) is assigned.
- USERID_LENGTH
- is the length of the USERID value.
- ESM_RESPONSE
- Optional Parameter
- is the optional 32-bit ESM response code to the call.
- SAF_RESPONSE
- Optional Parameter
- is the optional 32-bit SAF response code to the call.