Command Reference › LISTAUTH Command › Description

Description

The LISTAUTH command lets you query the GRANT, LIST, and WITHHOLD records in the AUTHORIZ CONFIG file to determine whether a user ID has a specific authorization and responds by displaying the GRANT and WITHHOLD records that relate to the specified authorization.

The LISTAUTH command is very similar to the MAY command. Both respond to your queries by displaying the GRANT and WITHHOLD records that relate to the specified authorization, but the MAY command also responds by return code.

If you specify fewer authorities than are possible for a particular authorization, the LISTAUTH command treats your request as if you supplied a trailing EVERYWRD. For example, the following commands mean the same: "Can Helen issue all forms of the ADMIN command?":

vmsecure listauth helen admin

or

vmsecure listauth helen admin everywrd

CA VM:Secure searches for authorizations that allow use of all forms of the ADMIN command, and responds with a message like the following:

ACCEPTED BY: GRANT ADMIN MANAGERS TO SUSAN HELEN JOHN

Examples

• To determine the CA VM:Secure authorizations JUNIOR has, enter:

  vmsecure listauth junior
  

• To display all authorizations that control the use of the CHANGE command, enter:

  vmsecure listauth anyusr change
  

• To find out if you authorized anyone to change SMITH’s user ID:

  vmsecure listauth anyusr change smith
  

Note: For information about how to find the final disposition of a user ID’s authorization for a command or function, see the MAY Command.