User Exit Reference › USERPASS User Exit (CA VM:Secure only) › Definitions

Definitions

userid

The user ID being logged on. Special users should be exempted from action taken in this user exit. This prevents a malicious user from disabling user IDs that are necessary for normal operation of the system. At least one of these special user IDs should have RESET or JOURNAL authorization in the AUTHORIZ CONFIG file.

termaddr

The terminal address from which the LOGON or LOGONBY command was issued. Exempt switched terminals from action taken in this user exit, because their addresses are not significant.

Note: For more information, see Terminal Addresses.

Possible forms of termaddr are:

logonid

A temporary ID assigned to a VMDBK at logon time.

userid2

The user ID that attempted to log on to the userid using LOGONBY.

pswd

The invalid password supplied at the last logon attempt.

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

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

date

The date in mm/dd/yy format when the user reached the maximum number of invalid password attempts as specified on the JOURNAL record in the SECURITY CONFIG file.

time

The time in hh:mm:ss format when the user reached the maximum number of invalid passwords attempts as specified on the JOURNAL record in the SECURITY CONFIG file.

termtype

The type of terminal from which access was attempted under the LOGONBY Facility, or the LOGON, LOGON BY, DIAL, or from a Diagnose X’A0’ subcode 4 command.