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.


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