Previous Topic: TERMPASS User Exit (CA VM:Secure only)

Next Topic: Return Codes

Definitions

userid

Specifies the user ID being logged on.

termaddr

Specifies the terminal address from which access was attempted using the LOGONBY Facility, or the LOGON, LOGON BY, or DIAL commands. 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:

termaddr

Meaning

nnnn

Address of a real terminal device, represented by four hexadecimal digits. (Example: 0024)

Lnnnn

Address of a logical device, represented by an L and four hexadecimal digits. (Example: L0123)

nnn.nnn.nnn.nnn

Address of a TN3270 connected terminal, represented by an eight‑character hexadecimal representation of the standard dotted IPv4 address form. (Example: 0A005933 represents the dotted IP address 10.0.89.51)

nnnn:nnnn:nnnn:nnnn:nnnn:nnnn:nnnn:nnnn

Address of an IPv6 TN3270 connected terminal, represented by a standard IPv6 address.

nnnnnnnn

Address of an SNA or VTAM logical unit name. (Example: WEST0016)

logonid

A temporary ID assigned to a VMDBK at logon or dial time.

Userid2

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

pswd

The invalid password supplied at the last logon, logonby, or dial 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 string arguments.

date

The date in mm/dd/yy format when the number of invalid passwords from the same device reaches the maximum defined on the JOURNAL record in the SECURITY CONFIG file.

time

The time in hh:mm:ss format when the number of invalid passwords from the same device reaches the maximum defined 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, or DIAL commands.

termtype

Means the address passed to the user exit is

REAL

A real terminal device

LDEV

A logical device

IPADDR

A TCP/IP‑created logical device

NETID

The address of an SNA or VTAM logical unit name