XSAD gate, ADD_USER_WITHOUT_PASSWORD function

The ADD_USER_WITHOUT_PASSWORD function of the XSAD gate is used to add a user to the security domain without verification of a associated password or oidcard.

Input Parameters

APPLID
is the application identifier for the CICS region.
SIGNON_TYPE
is the type of signon for the userid (specified by the USERID value).
Values for the parameter are:
  • ATTACH_SIGN_ON
  • DEFAULT_SIGN_ON
  • IRC_SIGN_ON
  • LU61_SIGN_ON
  • LU62_SIGN_ON
  • NON_TERMINAL_SIGN_ON
  • PRESET_SIGN_ON
  • USER_SIGN_ON
  • XRF_SIGN_ON
USERID
is the identifier of the user (a userid of 1 through 10 alphanumeric characters) to be added to the security domain.
USERID_LENGTH
is the length of the USERID value.
ENTRY_PORT_NAME
Optional Parameter
is an optional name of an entry port, 1 through 8 alphanumeric characters, to be assigned to the userid (specified by the USERID value).
ENTRY_PORT_TYPE
Optional Parameter
is the type of the optional entry port to be assigned to the userid (specified by the USERID value). This parameter is only valid if ENTRY_PORT_NAME is also specified.
Values for the parameter are:
  • CONSOLE
  • TERMINAL
GROUPID
Optional Parameter
is an optional identifier, 1 through 10 alphanumeric characters, of a RACF user group to which the userid (specified by the USERID value) is to be assigned.
GROUPID_LENGTH
Optional Parameter
is the 8-bit length of the GROUPID value. This parameter is only valid if GROUPID is also specified.

Output Parameters

REASON
The following values are returned when RESPONSE is DISASTER:
  • ABEND
  • LOOP
The following values are returned when RESPONSE is EXCEPTION:
  • APPLICATION_NOTAUTH
  • ENTRY_PORT_NOTAUTH
  • ESM_INACTIVE
  • ESM_TRANQUIL
  • GETMAIN_FAILURE
  • GROUP_ACCESS_REVOKED
  • INVALID_GROUPID
  • INVALID_USERID
  • SECLABEL_FAILURE
  • SECURITY_INACTIVE
  • UNKNOWN_ESM_ERROR
  • USERID_NOT_DEFINED
  • USERID_NOT_IN_GROUP
  • USERID_REVOKED
The following values are returned when RESPONSE is INVALID:
  • INVALID_FORMAT
  • INVALID_FUNCTION
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
SECURITY_TOKEN
is the token identifying the userid.
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_XSADadd_user_without_password.html | Timestamp icon Last updated: Monday, 5 June 2017