| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Display Authority (DSPAUT) command shows the list of authorized users of an object and their authorities for the object. If the object is secured by an authorization list, the name of the authorization list is also shown.
The following are shown for the specified object:
If an object does not have an owner name associated with it, no authorities for the object are shown.
See Appendix D of the iSeries Security Reference, SC41-5302 for the authorities needed to use this command.
For more information about integrated file system commands, see the Integrated file system information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| OBJ | Object | Path name | Required, Positional 1 |
| SYMLNK | Symbolic link | *NO, *YES | Optional |
| OUTPUT | Output | Optional |
| Top |
Specifies the objects for which the authorized users and their authorities are displayed.
For more information on specifying path names, refer to "Object naming rules" in the CL concepts and reference topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
This is a required parameter.
The object path name can be either a simple name or a name that is qualified with the name of the directory in which the object is located. A pattern can be specified in the last part of the path name. An asterisk (*) matches any number of characters and a question mark (?) matches a single character. If the path name is qualified or contains a pattern, it must be enclosed in apostrophes.
| Top |
If the last component in the path name is a symbolic link, specifies whether or not to display the symbolic link or the object pointed to by the symbolic link.
| Top |
Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.
| Top |
Example 1: Displaying Users and Authorities
DSPAUT OBJ('/QSYS.LIB/ARLIB.LIB/PROG1.PGM')
This command shows the authorized users and their authorities for the object named PROG1 to the user who entered the command, if that user has object management authority for the object. PROG1 is a program located in the library named ARLIB. The system assumes * for the device that shows the output list. If the command was entered in the batch subsystem, the output is placed in the default output queue for the job. If the command was entered in the interactive subsystem, the output is shown on the device where the user entered the command.
Example 2: Printing List of Users
DSPAUT OBJ('/MYDIR/MYOBJECT') OUTPUT(*PRINT)
This command causes the list of authorized users of MYOBJECT in the MYDIR directory to be printed.
| Top |
*ESCAPE Messages
| Top |