Work with Output Queue (WRKOUTQ)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Work with Output Queues (WRKOUTQ) command allows the user to display and work with either the overall status of all output queues or all output queues that match the qualified generic name specified and to which the user is authorized, or the detailed status of a specific output queue. The status of the queues may change while the command is being run.

Top

Parameters

Keyword Description Choices Notes
OUTQ Output queue Single values: *ALL
Other values: Qualified object name
Optional, Positional 1
Qualifier 1: Output queue Generic name, name
Qualifier 2: Library Name, *LIBL, *CURLIB, *ALL
OUTPUT Output *, *PRINT Optional, Positional 2
Top

Output queue (OUTQ)

Specifies either that the status of all output queues or all output queues that match the qualified generic name specified is shown, or specifies the qualified name of a single output queue for which the status is shown.

Note: When a generic output queue name is specified and qualified with a library name, the overall status of all output queues that match the generic name is shown even if there is only one output queue that matches the generic name.

Single values

*ALL
A list of all output queues is displayed with information about each output queue. If *ALL is specified, no value can be specified for a library name because *ALL provides a list of all output queues in every library on the system.

Qualifier 1: Output queue

generic-name
Specify the generic name of the output queues whose detailed status information are to be displayed. A list of all spooled files on the output queue is displayed with information about each spooled file.
name
Specify the name of the output queue whose detailed status information is to be displayed. A list of all spooled files on the output queue is displayed with information about each spooled file.

Qualifier 2: Library

*LIBL
All libraries in the library list for the current thread are searched until the first match is found.
*CURLIB
The current library for the job is used to locate the output queue.
*ALL
All libraries in the system, including QSYS, are searched.

Note: When *ALL is specified for the library, the overall status of the output queues is shown even if only one output queue is found.

name
Specify the name of the library where the output queue is located.
Top

Output (OUTPUT)

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

*
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 on a printer.
Top

Examples

Example 1: Working with Status Information for Specific Output Queue

WRKOUTQ   OUTQ(QGPL/QPRINT)

This command displays the Work with Output Queue panel for output queue QPRINT in library QGPL. Each spooled file on the QPRINT output queue is shown.

Example 2: Searching for Output Queues Using a Generic Name

WRKOUTQ   OUTQ(QGPL/QPRI*)

This command displays the Work with All Output Queues panel, showing a list of all output queues whose names start with the letters 'QPRI' and exist in the QGPL library.

Top

Error messages

*ESCAPE Messages

CPF2207
Not authorized to use object &1 in library &3 type *&2.
CPF3302
Override of print file &1 to file &2 not valid.
CPF3330
Necessary resource not available.
CPF3357
Output queue &1 in library &2 not found.
CPF7D41
Error occurred while logging order assistance request.
CPF7D42
Error occurred while performing database operation.
CPF9845
Error occurred while opening file &1.
CPF9846
Error while processing file &1 in library &2.
CPF9871
Error occurred while processing.
Top