The Clear Output Queue 3 command clears selected spooled files from
an output queue. Spooled files may be deleted based on a combination
of selection criteria such as job, user, form type, status, and
priority. At least one selection type must be made. A spooled file
must satisfy all selection types specified to be deleted. A 'check
option' exists to allow a determination of which spooled files would
be deleted.
You must have *JOBCTL special authority to use CLROUTQ3.
A typical command would be:
CLROUTQ3 OUTQ(xxx) FILE(fff)
All spooled files on the output queue for the specified spooled file
name would be deleted. A message for each spooled file deleted would
appear.
Multiple selection criteria may be used such as:
CLROUTQ3 OUTQ(xxx) JOB(ABC*) USER(uuu)
Any spooled file in a job beginning with ABC and the specified user
would be deleted.
CLROUTQ3 escape messages you can monitor for
--------------------------------------------
TAA9891 No spooled files exist on the output queue
TAA9892 Some error occurred
TAA9893 No spooled files match the selection criteria
Escape messages from based on functions will be re-sent.
CLROUTQ3 Command parameters *CMD
---------------------------
OUTQ The qualified name of the output queue. The library
value defaults to *LIBL. A specific library or
*CURLIB may also be used.
JOB The job or generic job name to deletes spooled files
for. The default is *ALL meaning all jobs are
considered.
USER The user or generic user of a job to have spooled
files deleted. The default is *ALL meaning all
users are considered.
JOBNBR The job number to have spooled files deleted. The
default is *ALL meaning all job numbers are
considered.
SPLF The spooled file name or generic name to be deleted.
The default is *ALL meaning all spooled files are
considered.
USRDTA The user data of the spooled files to be deleted.
The default is *ALL meaning all user data is
considered.
FORMTYPE The form type of the spooled files to be deleted.
The default is *ALL meaning all form types are
considered.
STATUS The status of jobs to be ended. The default is *ALL
meaning all status conditions are considered. A
value of *RDY, *OPN, *DFR, *SND, *CLO, *HLD, *SAV,
*WTR, *PND, *PRT, or *MSGW may be entered.
OUTPTY The priority of jobs to be ended. The default is
*ALL meaning all priorities are considered. A value
between 1 and 9 may be entered.
DLTSPLF The action to be taken if a spooled file is
selected.
*CHECK is the default to receive messages on which
spooled files would be deleted.
*YES may be specified to delete any selected spooled
files.
Restrictions
------------
You must have *JOBCTL special authority to use CLROUTQ3.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKGENERC Check generic
CHKJOBCTL Check *JOBCTL special authority
CHKOBJ3 Check object 3
CHKSPLF Check spooled file
CVTOUTQ Convert output queue
EDTVAR Edit variable
RSNLSTMSG Resend last message
RTVOUTQA Retrieve output queue attributes
SNDCOMPMSG Send completion message
SNDESCINF Send escape information
SNDESCMSG Send escape message
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
CLROUTQ3 *CMD TAASPPO QATTCMD
TAASPPOC *PGM CLP TAASPPOC QATTCL
|
