RESET Command

Reference Guide › Command Reference › RESET Command

RESET Command

Use the RESET command to reset to zero the number of invalid password attempts recorded for a specific user ID or terminal.

RESET {"Parms"}

Parms:

  AUTOLOG requester [targetid]
| DEVICE termaddr
| LINK requester [targetid [vaddr]]
| USER userid
| USERPASS userid
| VMXLINK requester [targetid [vaddr]]
| XAUTOLOG requester [targetid]

Definitions

AUTOLOG requester [targetid]

Clears the journal count for a password violation committed by requester while autologging targetid. If you do not specify targetid, the command clears all invalid autolog attempts by requester. When you do not specify targetid and the RESET command resets the journal count for more than one user ID, CA VM:Secure creates an audit record for each user ID.

DEVICE termaddr

Clears the journal count for password violations committed from the device at termaddr at logon. For more information about terminal addresses, see Terminal Addresses.

Possible values for 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 the standard dotted IPv4 address form. (Example: 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, represented by up to eight characters. (Example: WEST0016)

LINK requester [targetid [vaddr]]

Clears the journal count for a link password violation committed while requester was attempting to link to the targetid vaddr minidisk using the CP LINK command. If vaddr is an asterisk, journal counts for all minidisks owned by targetid are reset. This is the default.

If you do not specify targetid, the command clears all invalid link attempts by requester. When you do not specify targetid and the RESET command resets the journal count for more than one user ID, CA VM:Secure creates an audit record for each user ID.

USER userid

Clears the journal count for password violations committed by userid at logon.

USERPASS userid

Clears the journal count for password violations committed by userid while CA VM:Secure was verifying that userid was indeed the user. This includes attempted links controlled by a rule with the LOGPASS option specified.

VMXLINK requester [targetid [vaddr]]

Clears the journal count for a link password violation committed while the requester tried to define a directory link to the targetid vaddr minidisk. If you specify an asterisk for vaddr, the command resets journal counts for all minidisks owned by targetid. This is the default.

If you do not specify targetid, the command clears all invalid link password violations by requester while attempting to define a directory link. When you do not specify targetid and the RESET command resets the journal count for more than one user ID, CA VM:Secure creates an audit record for each user ID.

XAUTOLOG requester [targetid]

Clears the journal count for a password violation committed by requester while xautologging targetid. If you do not specify targetid, the command clears all invalid xautolog attempts by requester. When you do not specify targetid and the RESET command resets the journal count for more than one user ID, CA VM:Secure creates an audit record for each user ID.

Description

The RESET command clears the number of invalid password attempts recorded for a specific user ID. The JOURNAL record in the SECURITY CONFIG file sets the maximum number of invalid passwords that a user ID can enter before CA VM:Secure prevents that user ID from doing any of the following:

Autologging, xautologging, linking, or logging on, depending on which monitored condition went over the maximum JOURNAL number in the SECURITY CONFIG file
Using CA VM:Secure commands if the password violations were in response to the verification password prompt
Defining a minidisk link for any minidisks belonging to the user ID for which link passwords were violated

Invalid password counts are set to zero when the CA VM:Secure service virtual machine is initialized.

The RESET command is similar in function to the JOURNAL command with the RESET parameter.

Note: If a directory manager exceeds the maximum number of invalid password entries while attempting to define a minidisk link on behalf of a user, the password violations are recorded against the directory manager. To clear the password violations recorded, issue the RESET command with the directory manager user ID as requester and the user ID of the minidisk owner as the targetid.

Examples

To clear the invalid password record for HANK’s invalid attempts to use a CA VM:Secure command, enter:
```
vmsecure reset userpass hank
```
To clear the JOURNAL count for EDDIE’s invalid attempts to define a directory link to the EARL 191 minidisk, enter:
```
vmsecure reset vmxlink eddie earl 191
```

Note: To use the JOURNAL command as another method of clearing and resetting journal information, see JOURNAL Command.