The Display Authorization List (DSPAUTL) command shows the list of users (and their levels of authority) that make up the authorization list.

When an authorization list is first shown, the specific authorities shown are determined by the level of detailed information specified on the USROPT parameter in the user profile.

When the DSPAUTL command is used to display an authorization list, the user specifies the name of the authorization list, whether the authorization list should be shown on the display or sent to a printer, or (optionally) whether the output should be sent to an OUTFILE.

Parameters

Keyword	Description	Choices	Notes
AUTL	Authorization list	Qualifier list	Required, Positional 1
	Qualifier 1: Authorization list	Name
OUTPUT	Output	*, *PRINT, *OUTFILE	Optional, Positional 2
OUTFILE	File to receive output	Qualified object name	Optional
	Qualifier 1: File to receive output	Name
	Qualifier 2: Library	Name, *LIBL, *CURLIB
OUTMBR	Output member options	Element list	Optional
	Element 1: Member to receive output	Name, *FIRST
	Element 2: Replace or add records	*REPLACE, *ADD

Top

Authorization list (AUTL)

Specifies the authorization list to be shown.

This is a required parameter.

name

Specify the name of the authorization list.

Output (OUTPUT)

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

*

The output is displayed (if requested by an interactive job) or printed with the job's spooled output (if requested by a batch job).

*PRINT

The output is printed with the job's spooled output.

*OUTFILE

The output is directed to the database file specified for the File to receive output (OUTFILE) parameter.

File to receive output (OUTFILE)

Specifies the database file to which the output of the command is directed. If the file does not exist, this command creates a database file in the specified library. If the file is created, the public authority for the file is the same as the create authority specified for the library in which the file is created. Use the Display Library Description (DSPLIBD) command to show the library's create authority.

Qualifier 1: File to receive output

name

Specify the name of the database file to which the command output is directed.

Qualifier 2: Library

*LIBL

The library list is used to locate the file. If the file is not found, one is created in the current library. If no current library exists, the file will be created in the QGPL library.

*CURLIB

The current library for the thread is used to locate the file. If no library is specified as the current library for the thread, the QGPL library is used.

name

Specify the name of the library to be searched.

Note: If a new file is created, system file QAOBJAUT in system library QSYS with a format name of QSYDSAUT is used as a model.

Output member options (OUTMBR)

Specifies the name of the database file member that receives the output of the command.

Element 1: Member to receive output

*FIRST

The first member in the file receives the output. If OUTMBR(*FIRST) is specified and the member does not exist, the system creates a member with the name of the file specified for the File to receive output (OUTFILE) parameter. If the member already exists, you have the option to add new records to the end of the existing member or clear the member and then add the new records.

name

Specify the name of the file member that receives the output. If it does not exist, the system creates it.

Element 2: Replace or add records

*REPLACE

The system clears the existing member and adds the new records.

*ADD

The system adds the new records to the end of the existing records.

Examples

DSPAUTL   AUTL(DEPT48X)  OUTPUT(*PRINT)

This command sends the display of the authorization list to the printer.

Error messages

*ESCAPE Messages

CPF2204

User profile &1 not found.

CPF2207

Not authorized to use object &1 in library &3 type *&2.

CPF2208

Object &1 in library &3 type *&2 not found.

CPF2209

Library &1 not found.

CPF2211

Not able to allocate object &1 in &3 type *&2.

CPF2216

Not authorized to use library &1.

CPF2283

Authorization list &1 does not exist.

CPF9843

Object &1 in library &3 type &2 cannot be accessed.

CPF9860

Error occurred during output file processing.