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