Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

Qualifiers

/IDENTIFIER

/PROXY

/RIGHTS

/BRIEF

/FULL

Parameter

Qualifiers

Examples

/USER

/VALUE

Example

Parameter

Qualifier

Example

/USER

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

/IDENTIFIER/PROXY/RIGHTS

Qualifiers

Additional information available:

/BRIEF/FULL

/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:

ParameterQualifiersExamples

Parameter

 id-name

 Specifies an identifier name.  If you omit the identifier name,
 you must specify /USER or /VALUE.

Qualifiers

Additional information available:

/USER/VALUE

/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

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:

ParameterQualifierExample

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=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.

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026