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.


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