USAD gate, ADD_USER_VIA_ICRX function

The ADD_USER_VIA_ICRX function of the USAD gate provides the External Security Manager with an ICRX that can be mapped to a user.

Input Parameters

ICRX
Is the extended identity context reference (ICRX) of the user.
SUSPEND
Optional parameter.
Indicates whether a wait during add user processing is acceptable.
Values for the parameter are:
  • NO
  • YES

Output Parameters

REASON
The following values are returned when RESPONSE is DISASTER:
  • DEL_TIMEOUT_ENTRY_FAILED
  • EXTRACT_FAILED
  • GETMAIN_FAILED
The following values are returned when RESPONSE is EXCEPTION:
  • ALREADY_SIGNED_ON
  • APPLICATION_NOTAUTH
  • ENQ_LIMIT_EXCEEDED
  • ENTRY_PORT_NOTAUTH
  • ESM_INACTIVE
  • ESM_TRANQUIL
  • GROUP_ACCESS_REVOKED
  • INVALID_GROUPID
  • INVALID_USERID
  • SECLABEL_CHECK_FAILED
  • SECURITY_INACTIVE
  • UNKNOWN_ESM_RESPONSE
  • USER_NOT_LOCATED
  • USERID_NOT_IN_GROUP
  • USERID_REVOKED
The following values are returned when RESPONSE is INVALID:
  • INVALID_FORMAT
  • INVALID_FUNCTION
  • INVALID_PARAMETERS
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
SAF_RESPONSE
Optional parameter.
Is the optional 32-bit SAF response code to the call.
ESM_RESPONSE
Optional parameter.
Is the optional 32-bit ESM response code to the call.
USERID_LENGTH
Optional parameter.
Is the length of the user ID value.
USERID
Optional parameter.
Is the identifier of the user (a 1- to 10-character alphanumeric user ID) added to the security domain.


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