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.