1 LIST Writes reports for selected UAF records to a listing file, SYSUAF.LIS, which is placed in the current default directory. In the list of "Additional information available" in online help, the first group of qualifiers determines whether a /BRIEF or /FULL report is to be written to SYSUAF.LIS. Following these qualifiers, after "Examples," are additional qualifiers, some of which have their own parameters and qualifiers: o /IDENTIFIER-creates the listing file RIGHTSLIST.LIS o /PROXY-creates a listing file from the network database file, NET$PROXY.DAT o /RIGHTS-lists identifiers held Format LIST [user-spec] 2 Parameter user-spec Specifies the user name or UIC of the requested UAF record. Without the user-spec parameter, AUTHORIZE lists the user records of all users. The asterisk (*) and percent sign (%) wildcards are permitted in the user name. 2 Qualifiers /BRIEF Specifies that a brief report be written to SYSUAF.LIS. The /BRIEF qualifier is the default qualifier. SYSUAF.LIS is placed in the default directory. /FULL Specifies that a full report be written to SYSUAF.LIS, including identifiers held by the user. SYSUAF.LIS is placed in the SYS$SYSTEM directory. The LIST command creates a listing file of reports for selected UAF records. Print the listing file, SYSUAF.LIS, with the DCL command PRINT. Specification of a user name results in a single-user report. Specification of the asterisk wildcard character following the LIST command results in reports for all users in ascending sequence by user name. Specification of a UIC results in reports for all users with that UIC. (HP recommends that you assign each user a unique UIC, but if users share a UIC, the report will show all users with that UIC.) You can use the asterisk wildcard character to specify the UIC. The following table shows how to specify a UIC with the LIST command and use the asterisk wildcard character with the UIC specification to produce various types of reports: Command Description LIST [14,6] Lists a full report for the user (or users) with member number 6 in group 14. LIST [14,*] Lists a brief report for all users in group /BRIEF 14, in ascending sequence by member number. LIST [*,6] /BRIEF Lists a brief report for all users with a member number of 6. LIST [*,*] /BRIEF Lists a brief report for all users, in ascending sequence by UIC. Although you must provide separate UICs for each user, the LIST command reports users with the same UIC in the order in which they were added to the SYSUAF. Full reports list the details of the limits, privileges, login flags, and command interpreter. Brief reports do not include the limits, login flags, or command interpreter, nor do they summarize the privileges. AUTHORIZE never displays the password for an account. See the SHOW command for examples of brief and full reports. 2 Examples 1.UAF> LIST ROBIN/FULL %UAF-I-LSTMSG1, writing listing file %UAF-I-LSTMSG2, listing file SYSUAF.LIS complete This command lists a full report for the user record ROBIN. 2.UAF> LIST * %UAF-I-LSTMSG1, writing listing file %UAF-I-LSTMSG2, listing file SYSUAF.LIS complete This command results in brief reports for all users in ascending sequence by user name. Note, however, that this is the same result you would produce had you omitted the asterisk wildcard. 3.UAF> LIST [300,*] %UAF-I-LSTMSG1, writing listing file %UAF-I-LSTMSG2, listing file SYSUAF.LIS complete This command lists a brief report for all user records with a group UIC of 300. 2 /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] 3 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. 3 Qualifiers /BRIEF Specifies a brief listing in which only the identifier name, value, and attributes appear. /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. /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. /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] 2 /PROXY Creates a listing file of the network proxy database entries from the network database file NET$PROXY.DAT. Format LIST/PROXY 3 Qualifiers /OLD Directs AUTHORIZE to display information from the NETPROXY.DAT file rather than from the default file NET$PROXY.DAT. If someone modifies the proxy database on a cluster node that is not running the current OpenVMS VAX system, then you can use the /OLD qualifier to list the contents of the old database: NETPROXY.DAT. 3 Example UAF> LIST/PROXY/OLD %UAF-I-LSTMSG1, writing listing file %UAF-I-NETLSTMSG, listing file NETPROXY.LIS complete The command in this example creates a listing file of all the entries in the network proxy database NETPROXY.DAT. 2 /RIGHTS Lists identifiers held by the specified identifier or, if /USER is specified, all identifiers held by the specified users. Format LIST/RIGHTS [id-name] 3 Parameter id-name Specifies the name of the identifier associated with the user. If you omit the identifier name, you must specify the /USER qualifier. 3 Qualifier /USER /USER=user-spec Specifies a user 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 UICs or all user names. UICs must be in the form [*,*], [n,*], [*,n], or [n,n]. A wildcard user name specification (*) or wildcard UIC specification ([*,*]) lists all identifiers held by users. The wildcard user name specification lists holders' user names alphabetically; the wildcard UIC specification lists them in the numerical order of their UICs. 3 Example UAF> LIST/RIGHTS PAYROLL %UAF-I-LSTMSG1, writing listing file %UAF-I-RLSTMSG, listing file RIGHTSLIST.LIS complete The command in this example lists identifiers held by PAYROLL, providing PAYROLL is the name of a UIC format identifier.