Clear Output Queue (CLROUTQ)

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

The Clear Output Queue (CLROUTQ) command removes spooled files from the specified queue. The Clear Output Queue (CLROUTQ) command removes all spooled files on the specified output queue if they are waiting to be written on an output device, including files that are in the hold state. Spooled files that are currently being produced by programs or that are being written to an output device are not removed from the queue.

Top

Parameters

Keyword Description Choices Notes
OUTQ Output queue Qualified object name Required, Positional 1
Qualifier 1: Output queue Name
Qualifier 2: Library Name, *LIBL, *CURLIB
Top

Output queue (OUTQ)

Specifies the output queue to be cleared of spooled files.

This is a required parameter.

Qualifier 1: Output queue

name
Specify the name of the output queue to be cleared.

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. If no current library entry exists in the library list, QGPL is used.
name
Specify the name of the library in which the output queue is located.
Top

Examples

CLROUTQ   OUTQ(QPRINT)

This command removes the entries for all spooled files from the output queue, QPRINT, that are waiting to be printed or are being held. The entries for the file currently being printed and files still receiving data from programs that are currently running are not affected.

Top

Error messages

*ESCAPE Messages

CPF2207
Not authorized to use object &1 in library &3 type *&2.
CPF3330
Necessary resource not available.
CPF3357
Output queue &1 in library &2 not found.
CPF3417
&1 entries deleted. &2 entries not deleted.
CPF9843
Object &1 in library &3 type &2 cannot be accessed.
Top