DSPAUT (Display Authority) Command Description

DSPAUT Command syntax diagram

Purpose

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 Link to PDF book for the authorities required to use this command.

For more information about integrated file system commands, see Integrated file system topic in the File systems and management category of the Information Center.

Required Parameter

OBJ
Specifies the path name of the object for which the authorized users and their authorities are displayed. For more information on specifying path names, refer to path names

Optional Parameter

OUTPUT
Specifies whether the output from the command is shown at the requesting work station or printed with the job's spooled output.

*: Output requested by an interactive job is shown on the display. Output requested by a batch job is printed with the job's spooled output.

*PRINT: The output is printed with the job's spooled output.

Examples for DSPAUT

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.

Error messages for DSPAUT

*ESCAPE Messages

CPDA080
User profile name too long.
CPE3101
A non-recoverable I/O error occurred.
CPE3408
The address used for an argument was not correct.
CPE3418
Possible APAR condition or hardware failure.
CPE3474
Unknown system state.
CPFA0AA
Error occurred while attempting to obtain space.
CPFA0AB
Object name not a directory.
CPFA0AD
Function not supported by file system.
CPFA0A1
An input or output error occurred.
CPFA0A2
Information passed to this operation was not valid.
CPFA0A3
Path name resolution causes looping.
CPFA0A4
Too many open files for process.
CPFA0A5
Too many open files.
CPFA0A7
Path name too long.
CPFA0A9
Object not found.
CPFA0B1
Requested operation not allowed. Access problem.
CPFA0C0
Buffer overflow occurred.
CPFA0C1
CCSID &1 not valid.
CPFA08B
Path name cannot begin with *.
CPFA08C
Pattern not allowed in path name directory.
CPFA08E
More than one name matches pattern.
CPFA085
Home directory not found for user &1.
CPFA086
Matching quote not found in path name.
CPFA087
Path name contains null character.
CPFA088
Path name pattern not valid.
CPFA09C
Not authorized to object.
CPFA09D
Error occurred in program &1.
CPFA09E
Object in use.
CPFA09F
Object damaged.
CPFA091
Pattern not allowed in user name.
CPFA092
Path name not converted.
CPFA093
Name matching pattern not found.
CPFA094
Path name not specified.
CPF1F05
Directory handle not valid.
CPF1F41
Severe error occurred while addressing parameter list.
CPF1F4A
Value for number of directory entries not valid.
CPF1F53
Value for length of data buffer not valid.
CPF2203
User profile &1 not correct.
CPF2225
Not able to allocate internal system object.
CPF9801
Object &2 in library &3 not found.
CPF9802
Not authorized to object &2 in &3.
CPF9803
Cannot allocate object &2 in library &3.