XSAD gate, ADD_USER_WITH_PASSWORD function

The ADD_USER_WITH_PASSWORD function of the XSAD gate is used to add a user to the security domain and verify the associated password or oidcard.

Input Parameters

APPLID
is the application identifier for the CICS® region.
PASSWORD
is the current password, 1 through 10 alphanumeric characters, for the userid specified by the USERID value.
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. This parameter is only valid if ENTRY_PORT_NAME is also specified.
Values for the parameter are:
  • TERMINAL
  • CONSOLE
GROUPID
Optional Parameter
is an optional identifier, 1 through 10 alphanumeric characters, of a RACF® user group to which the userid 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.
NEW_PASSWORD
Optional Parameter
is a new password, 1 through 10 alphanumeric characters, to be assigned to the userid (specified by the USERID value). This parameter is only valid if PASSWORD is also specified.
OIDCARD
Optional Parameter
is an optional oidcard (operator identification card); a 65-byte field containing further security data from a magnetic strip reader (MSR) on 32xx devices.
PASSWORD_TYPE
Optional Parameter
specifies if the password is masked.

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_NEW_PASSWORD
  • INVALID_USERID
  • OIDCARD_NOTAUTH
  • OIDCARD_REQUIRED
  • PASSWORD_EXPIRED
  • PASSWORD_NOTAUTH
  • PASSWORD_REQUIRED
  • 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_with_password.html | Timestamp icon Last updated: Monday, 5 June 2017