WRKOUTQ (Work with Output Queues)

WRKOUTQ Command syntax diagram

 

Purpose

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.

 

Optional Parameters

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.

*ALL: The overall status of all output queues is shown.

The name of the output queue can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

*ALL: All libraries in the system, including QSYS, are searched.

library-name: Specify the name of the library to be 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.

output-queue-name: Specify the name of the output queue whose detailed status information is shown.

OUTPUT

Specifies whether the output from the command is shown at the requesting work station or is printed with the job's spooled output. More information on this parameter is in commonly used parameters.

*: 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 of WRKOUTQ

Example 1: Working with Status Information for Specific Output Queue

WRKOUTQ  OUTQ(QGPL/QPRINT)

This command allows the user to show and work with the detailed status information about the output queue named QPRINT in the QGPL library. 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 allows the user to show and work with the overall status information of the output queues whose names start with QPRI and exist in the QGPL library.

Error messages for WRKOUTQ

*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.