Previous Topic: Audit Record FormatNext Topic: COMMAND User Exit


CHKPASS User Exit

Use the CHKPASS user exit to verify logon passwords entered for executing CA VM:Director commands, certain CP or CA VM product commands.

CHKPASS userid pswd

Definitions

userid

The user ID issuing the CA VM:Director command.

pswd

The password or password phrase entered in response to the CA VM:Director prompt for the logon password.

Description

The CHKPASS user exit verifies logon passwords entered for executing CA VM:Director commands. Without a CHKPASS user exit, CA VM:Director verifies passwords by checking the CP directory. The exit does not receive control if the user issuing the command has NOPASS authorization.

A pswd argument which contains embedded blanks is passed within the argument string enclosed in single quotes. The user exit sample program contains code to parse the argument string into variables. You must use this method if you use password phrases.

A CHKPASS user exit is essential for sites that use security packages where the logon password is not stored in the CP directory.

Return Codes

The following table describes the return codes:

Return Code

Meaning

0

Password entered is valid and processing continues for the command entered

<>0

Any non-zero return code indicates the password is invalid and processing terminates for the command