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.


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