Exit the file and check it into Help as UAFHELP.HLP. This help is
internal utility help that gets checked into the [UAF] facility.
Creates a listing file (RIGHTSLIST.LIS) in which identifier
names, attributes, values, and holders are written.
Format
LIST/IDENTIFIER [id-name]
1 – Parameter
id-name
Specifies an identifier name. You can specify the asterisk
wildcard character (*) to list all identifiers. If you omit the
identifier name, you must specify /USER or /VALUE.
2 – Qualifiers
2.1 /BRIEF
Specifies a brief listing in which only the identifier name,
value, and attributes appear.
2.2 /FULL
Specifies a full listing, in which the names of the identifier's
holders are displayed along with the identifier's name, value,
and attributes. The /FULL qualifier specifies the default listing
format.
2.3 /USER
/USER=user-spec
Specifies one or more users whose identifiers are to be listed.
The user-spec can be a user name or UIC. You can use the
asterisk wildcard character (*) to specify multiple user names
or UICs. UICs must be in the form [*,*], [n,*], [*,n], or
[n,n]. A wildcard user name specification (*) lists identifiers
alphabetically by user name; a wildcard UIC specification ([*,*])
lists them numerically by UIC.
2.4 /VALUE
/VALUE=value-specifier
Specifies the value of the identifier to be listed. The following
formats are valid for the value-specifier:
IDENTIFIER:n An integer value in the range 65,536 to
268,435,455. You can also specify the value
in hexadecimal (precede the value with %X) or
octal (precede the value with %O).
To differentiate general identifiers from UIC
identifiers, %X80000000 is added to the value
you specify.
GID:n GID is the POSIX group identifier. It is an
integer value in the range 0 to 16,777,215
(%XFFFFFF). The system will add %XA400.0000
to the value you specify and then enter this
new value into the system RIGHTSLIST as an
identifier.
UIC:uic A UIC value in the standard UIC format.
3 – Examples
1.UAF> LIST/IDENTIFIER INVENTORY
%UAF-I-LSTMSG1, writing listing file
%UAF-I-RLSTMSG, 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.
2.UAF> LIST/IDENTIFIER/USER=ANDERSON
%UAF-I-LSTMSG1, writing listing file
%UAF-I-RLSTMSG, listing file RIGHTSLIST.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]
UAF> LIST/IDENTIFIER/VALUE=UIC:[300,015]