The Print All Output Queues command prints one line per output queue
for one or many output queues. Each line has the total number of
spooled files, the number of pages to be printed, and the allocated
size of the spooled files. Options exist to bypass output queues
that do not have any spooled files and select those output queues
that have spooled files that match a status such as HLD.
In order to determine the allocated size of the spooled files, the
TAA command CVTOUTQ is used internally to create one record for each
spooled file. If many spooled files exist, this process can be slow.
You must have *ALLOBJ special authority to specify a library value of
*ALL or *ALLUSR. You must have authorization to any output queue
specified.
A typical command to review all of the output queues on the system
would be:
PRTALLOUTQ
An option exists to bypass the output queues that do not have any
spooled files.
PRTALLOUTQ BYPASS(*YES)
An option exists to list only those output queues that have spooled
files in a particular status such as *RDY, *HLD, *SAV etc.
Specifying a spooled file status requires the use of BYPASS(*YES).
PRTALLOUTQ BYPASS(*YES) SPLFSTS(*HLD)
PRTALLOUTQ escape messages you can monitor for
----------------------------------------------
None. Escape messages from based on functions will be re-sent.
Command parameters *CMD
------------------
OUTQ The qualified name of the output queues to be
printed. The default is *ALL. A single output
queue or a generic name may also be entered.
The library value defaults to *ALL. *LIBL,
*USRLIBL, *CURLIB, or *ALLUSR may also be entered.
BYPASS A *YES/*NO parameter for whether to bypass the
output queues that have no spooled files.
*NO is the default meaning all output queues
requested will be listed.
*YES may be specified to bypass any output queues
that do not have any spooled files. *YES must be
specified if SPLFSTS is not *ALL.
SPLFSTS Whether to select only a particular status of a
spooled file. *ALL is the default for *ALL types of
status.
A specific status may be specified from the list of
*RDY, *OPN, *DFR, *SND, *CLO, *HLD, *SAV, *WTR,
*PND, *PRT, or *MSGW. For example, if *HLD is
specified, only those output queues that have
spooled files in a *HLD status will be listed.
If a particular status is named, BYPASS(*YES) must
be specified.
Restrictions
------------
You must have *ALLOBJ special authority to specify a library value of
*ALL or *ALLUSR.
You must have authorization to any output queue specified.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKALLOBJ Check *ALLOBJ special authority
CRTUSRSPC Create user space
CVTOUTQ Convert output queue
RTVOBJLST Retrieve object list
RTVOUTQA Retrieve output queue attributes
RTVSYSVAL3 Retrieve system value 3
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
------ ---- --------- ---------- ----------
PRTALLOUTQ *CMD TAASPNY QATTCMD
TAASPNYC *PGM CLP TAASPNYC QATTCL
TAASPNYR *PGM RPG TAASPNYR QATTRPG
|