UAFHELP.HLB  —  LIST  /IDENTIFIER
     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]
Close Help