XSPW gate, INQUIRE_PASSWORD_DATA function

The INQUIRE_PASSWORD_DATA function of the XSPW gate provides information from the ESM.

Input Parameters

PASSWORD
is the current password, 1 through 10 alphanumeric characters, for the userid specified by the USERID value.
PASSWORD_LENGTH
is the 8-bit length of the PASSWORD value. This parameter is only valid if PASSWORD is also specified.
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.
PASSWORD_TYPE
Optional Parameter
specifies if the password is masked.
Values for the parameter are:
  • CLEAR
  • MASKED

Output Parameters

REASON
The following values are returned when RESPONSE is DISASTER:
  • ABEND
  • ESM_ABENDED
  • ESTAE_FAILURE
  • EXTRACT_FAILURE
  • LOOP
The following values are returned when RESPONSE is EXCEPTION:
  • APPLID_NOTAUTH
  • ESM_INACTIVE
  • GROUP_CONNECTION_REVOKED
  • NOTAUTH
  • PASSWORD_EXPIRED
  • PASSWORD_NOTAUTH
  • SECURITY_INACTIVE
  • UNKNOWN_ESM_ERROR
  • USERID_FORMAT_ERROR
  • USERID_REVOKED
  • USERID_UNDEFINED
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.
CHANGE_ABSTIME
Optional Parameter
is the date and time of when the password was last changed.
DAYS_LEFT
Optional Parameter
is the number of days remaining before the password must be changed.
ESM_RESPONSE
Optional Parameter
is the optional 32-bit ESM response code to the call.
EXPIRY_ABSTIME
Optional Parameter
is the date and time of when the password will expire.
LASTUSE_ABSTIME
Optional Parameter
is the date and time of when the password was last used.
PASSWORD_FAILURES
Optional Parameter
is the number of times that the user has unsuccessfully entered tried to enter the password.
SAF_RESPONSE
Optional Parameter
is the optional 32-bit SAF response code to the call.


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