CLROUTQ (Clear Output Queue)

CLROUTQ Command syntax diagram

 

Purpose

The Clear Output Queue (CLROUTQ) removes spooled files from the specified output queue. The CLROUTQ command removes all spooled files that are waiting to be written on an output device from the specified queue, 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.

 

Required Parameters

OUTQ

Specifies the qualified name of the output queue.

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.

library-name: Specify the name of the library to be searched.

output-queue-name: Specify the name of the output queue that is cleared.

Example for CLROUTQ

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.

Error messages for CLROUTQ

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