USFL gate, FLATTEN_USER function
The FLATTEN_USER function of the USFL gate is used to flatten the user's security state and place into the FLATTENED_USER buffer provided.
Input Parameters
- FLATTENED_USER
- is the buffer into which the flattened security state is placed.
- USER_TOKEN
- is the token identifying the userid in the user domain.
Output Parameters
- REASON
- The following values are returned when RESPONSE is DISASTER:
- ABEND
- DIR_MANAGER_LOCATE_FAILED
- LOOP
- SEC_DOM_FLATTEN_FAILED
- The following values are returned when RESPONSE is EXCEPTION:
- ESM_INACTIVE
- ESM_TRANQUIL
- INVALID_USER_TOKEN
- SECURITY_INACTIVE
- UNKNOWN_ESM_RESPONSE
- The following values are returned when RESPONSE is INVALID:
- INVALID_FLATTENED_BUFFER
- INVALID_FORMAT
- INVALID_FUNCTION
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- 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.