USAD gate, INQUIRE_ICRX function
The INQUIRE_ICRX function of the USAD gate obtains ICRX data from the External Security Manager.
Input Parameters
- USER_TOKEN
- Optional parameter.
- Is the token identifying the user ID in the user domain.
- OUT_ICRX
- Optional parameter.
- Is the ICRX representing the user ID.
- ICRX_TYPE
- Optional parameter.
- Is the type of ICRX being requested.
- Values for the parameter are:
- COMPLETE: returns a copy of the RACF-generated ICRX.
- PSEUDO: returns a pseudo ICRX.
- RETRY
- Optional parameter.
- Used if the buffer size specified for the ICRX in a prior call was insufficient.
- RETRY(YES) returns a previously created ICRX. RETRY(NO) is the default.
- DNAME
- Optional parameter.
- The distinguished name associated with the ICRX-defined user ID.
- REALM
- Optional parameter.
- Is the realm associated with the ICRX-defined user ID.
- IN_RETRY_TOKEN
- Optional parameter.
- Used if the buffer size specified for the ICRX in a prior call was insufficient.
- This parameter must be set to the value returned in the previous OUT_RETRY_TOKEN.
Output Parameters
- REASON
- The following values are returned when RESPONSE is DISASTER:
- ABEND
- LOOP
- The following values are returned when RESPONSE is EXCEPTION:
- ICRX_NOT_AVAILABLE
- INVALID_USER_TOKEN
- The following values are returned when RESPONSE is INVALID:
- INVALID_FORMAT
- INVALID_FUNCTION
- OUT_RETRY_TOKEN
- Optional parameter.
- Used if the buffer size specified for the ICRX in a prior call was insufficient.
- If the buffer size was insufficient and OUT_RETRY_YES is specified, this parameter provides state data for the next call.
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- ICRX
- Is the extended identity context reference (ICRX) of the user.