AUTHORIZE LIST — MicroVMS 4.6
The LIST command outputs a listing file which gives information on the records specified. Unless otherwise specified by qualifiers, UAF records are listed.
Additional information available:
Qualifiers
Additional information available:
/BRIEF
This qualifier will give an abbreviated listing of the desired record(s). /BRIEF is equivalent to /NOFULL.
/FULL
This qualifier gives complete information on the desired record(s). /FULL is equivalent to /NOBRIEF. /FULL is the default.
/IDENTIFIER
Creates a listing file (RIGHTLIST.LIS) to which identifier
information is written.
Format
LIST/IDENTIFIER [id-name]
Additional information available:
Parameter
id-name Specifies an identifier name. If you omit the identifier name, you must specify /USER or /VALUE.
Qualifiers
Additional information available:
/USER
/USER=user-spec Specifies one or more users whose identifiers are to be listed. User-spec may be a username or UIC. You can user the asterisk wildcard to specify multiple usernames or UICs: full use of the asterisk and percent wildcards is permitted for usernames; UICs must be in the form [*,*], [*,n], or [n,*]. A wildcard username specification (i.e., *) lists identifiers alphabetically by username; a wildcard UIC specification (i.e., [*,*]) lists them numerically by UIC.
/VALUE
/VALUE=value-specifier
Specifies the value of the identifier to be listed. Valid
formats for the value-specifier are:
IDENTIFIER:integer An integer value in the range of
32768 to 268435455, or a
hexadecimal number in the range
%X00008000 to 0FFFFFFF
UIC:uic A uic value in the standard UIC
format
Examples
UAF> LIST/IDENTIFIER INVENTORY
writing listing file
listing file RIGHTSLIST.LIS complete
The command in this example generates a full listing for the
identifier INVENTORY, including its value (in hexadecimal),
holders, and attributes.
UAF> LIST/IDENTIFIER/USER=ANDERSON
writing listing file
listing file SYSUAF.LIS complete
This command lists an identifier associated with the user
ANDERSON, along with its value and attributes. Note, however,
that this is the same result you would produce had you
specified ANDERSON's UIC with the following forms of the
command:
UAF> LIST/IDENTIFIER/USER=[300,015]
or
UAF> LIST/IDENTIFIER/VALUE=UIC:[300,015]
/PROXY
Creates a listing file of all the network UAF records. The
/PROXY qualifier is required.
Format
LIST/PROXY
Additional information available:
Example
UAF> LIST/PROXY
writing listing file
listing file NETUAF.LIS complete
The command in this example creates a listing file of all the
network UAF records.
/RIGHTS
Lists the holders of the specified identifier, or, if /USER is
specified, all identifiers held by the specified user(s).
Format
LIST/RIGHTS [id-name]
Additional information available:
Parameter
id-name This is the name of the identifier (usually the username) associated with the user. If id-name is omitted, you must specify the /USER qualifier.
Qualifier
Additional information available:
/USER
/USER=user-spec Specifies a user whose identifiers are to be listed. User-spec may be a username or UIC. You can use the asterisk wildcard to specify multiple usernames or UICs: full user of the asterisk and percent wildcards is permitted for usernames; UICs must be in the form [*,*], [n,*], [n,n] or [*,n]. A wildcard username specification (i.e., *) or wildcard UIC specification (i.e., [*,*]) lists all identifiers held by users. The wildcard username specification lists holders' usernames alphabetically; the wildcard UIC specification lists them in the numerical order of their UICs.
Example
UAF> LIST/RIGHTS PAYROLL
writing listing file
listing file RIGHTSLIST.LIS is complete
The command is this example creates a listing file of all
holders of the identifier PAYROLL.