User Exit Reference › PASSWORD User Exit › Definitions

Definitions

userid

Specifies the user ID that is changing the password.

userid2

Specifies the user ID whose password is being changed.

newpw

Specifies the new password.

If you are using password encryption (PEF) this parameter is encrypted. The plain text version of this password is stored in the newpw parameter following date.

If you are configured for password phrases, then the newpw will be a quoted string, if it contains imbedded blanks.

The sample user exit provided illustrates the techniques needed for parsing quoted string arguments.

oldpw

Specifies the old password.

If you are configured for password phrases, then the oldpw will be a quoted string, if it contains imbedded blanks.

The sample user exit provided illustrates the techniques needed for parsing quoted string arguments.

date

Specifies the date on which the logon password was last changed, in the format yy/mm/dd. If the logon password has never been changed, no date is provided. If no date is available because the user’s directory entry has no password history statement, an asterisk is passed as the date. When the user exit is called for expired passwords during a LOGON process, an asterisk is passed as the date.

newpw

Specifies the plain text version of the new password and appears in the parameter list only if the Password Encryption Facility is installed.

If you are configured for password phrases, then the newpw will be a quoted string, if it contains imbedded blanks.

The sample user exit provided illustrates the techniques needed for parsing quoted string arguments.

pwlist

Specifies a list of previously used passwords, as a string of tokens separated by blanks. This information is supplied only if the directory entry for the virtual machine has a password history statement.

Note: If the Password Encryption Facility (PEF) is installed, all passwords in the parameter list (newpw, oldpw, pwlist) are encrypted except the new plain text password.

The date parameter and the unencrypted new password (newpw) parameter are always passed to the PASSWORD exit if PEF is installed.