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.


dfhs3_XSFLunflatten_esm_utoken.html | Timestamp icon Last updated: Monday, 5 June 2017