XSPW gate, UPDATE_PASSWORD function
The UPDATE_PASSWORD function of the XSPW gate assigns a new password to the userid, if the current password is input correctly and the new password meets ESM and installation defined password quality rules.
Input Parameters
- NEW_PASSWORD
- is the new password, 1 through 10 alphanumeric characters, for the userid specified by the USERID value.
- NEW_PASSWORD_LENGTH
- is the 8-bit length of the NEW_PASSWORD value.
- 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.
- USERID
- is the identifier of the user (a userid of 1 through 10 alphanumeric characters) requesting the ESM information.
- USERID_LENGTH
- is the length of the USERID value.
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:
- ESM_INACTIVE
- GROUP_CONNECTION_REVOKED
- INVALID_NEW_PASSWORD
- PASSWORD_NOTAUTH
- SECLABEL_FAILURE
- SECURITY_INACTIVE
- UNKNOWN_ESM_ERROR
- USERID_REVOKED
- USERID_UNDEFINED
- The following values are returned when RESPONSE is INVALID:
- INVALID_FORMAT
- INVALID_FUNCTION
- ESM_REASON
- is the external security manager's reason code.
- ESM_RESPONSE
- is the external security manager's response code.
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- SAF_REASON
- The system authorization facility's reason code.
- SAF_RESPONSE
- The system authorization facility's response to the call.