PASSCHNG User Exit

Reference Guide › User Exit Reference › PASSCHNG User Exit

PASSCHNG User Exit

Use the PASSCHNG user exit to provide information that can be used to notify other computer systems or operating systems that a logon password has been changed.

PASSCHNG userid target newpw status caller

Definitions

userid

The user ID that requested the password change.

target

The user ID whose password has been changed.

newpw

The new password, in plain text, for target.

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.

status

The new password status value on the *FL= special comment in the target user directory entry.

Value	Password Status
*	Active
E	Expired
N	New

caller: The name of the macro or command that called the PASSCHNG user exit.

Description

The PASSCHNG user exit is called by certain commands and menu selections after a logon password has been changed. It provides a list of parameters that can be used to allow notification of the change.

Return Codes

The following table describes the return codes:

Return Code	Meaning
0	Completed

Macros

The following macros call the PASSCHNG user exit:

Called by	Optimized Macro Name	Under These Circumstances
VMXPSW00	PASSWORD	A logon password is changed using the PASSWORD command
VMXUSE80	USE00080	A logon password is changed using the USER command
VMXMAI00	MAINT	A logon password is changed using the MAINT command with the PASSWORD parameter
VMXIPL00	IPLEDPGM	A logon password is changed at logon time by the IPL program (VMXIPL). Used when users are forced to change their password using the EXPIRE command.