USAD gate, ADD_USER_WITH_PASSWORD function
The ADD_USER_WITH_PASSWORD function of the USAD gate is used to add a user to the CICS(R) region and verify the associated password or oidcard.
Input Parameters
- 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.
- APPLID
- Optional Parameter
- is the application identifier for the CICS® region.
- 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:
- TERMINAL
- CONSOLE
- GROUPID
- Optional Parameter
- is an 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.
- 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.
- SCOPE_CHECK
- Optional Parameter
- indicates whether or not scope checking is to be performed for this function call.
- 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
- INQUIRE_PW_DATA_FAILED
- INVALID_GROUPID
- INVALID_NEW_PASSWORD
- INVALID_OIDCARD
- INVALID_PASSWORD
- INVALID_USERID
- NEW_PASSWORD_REQUIRED
- OIDCARD_REQUIRED
- PASSWORD_REQUIRED
- SECLABEL_CHECK_FAILED
- SECURITY_INACTIVE
- UNKNOWN_ESM_RESPONSE
- 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.
- USER_TOKEN
- is the token identifying the userid in the user domain.
- 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.