Reference Guide › User Exit Reference › PASSWORD User Exit

PASSWORD User Exit

Use the PASSWORD user exit to accept or reject the new logon password being specified.

The PASSWORD user exit has this syntax:

PASSWORD userid userid2 newpw oldpw [date [pwlist]]

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 configured for password phrases, then the newpw will be a quoted string, if it contains embedded 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 embedded 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.

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.

Return Codes

The following table describes the return codes:

Macros

The following macros call the PASSWORD user exit: