USAD gate, ADD_USER_WITHOUT_PASSWORD function

The ADD_USER_WITHOUT_PASSWORD function of the USAD gate is used to add a user to the CICS® region without verifying any password or oidcard.

Input Parameters

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:
  • 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.
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
SUSPEND
Optional Parameter
indicates whether a wait during add user processing is acceptable.
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
  • INVALID_GROUPID
  • INVALID_USERID
  • SECLABEL_CHECK_FAILED
  • SECURITY_INACTIVE
  • UNKNOWN_ESM_RESPONSE
  • USER_NOT_LOCATED
  • 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_without_password.html | Timestamp icon Last updated: Monday, 5 June 2017