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.