DSPEMTOUTQ DISPLAY EMPTY OUTPUT QUEUE TAASPPD |
The Display Empty Output Queues command displays one or more output
queues that have no entries. A flag may be set if the output queue
has not been used (such as not having any spooled files) in the last
n days. An option exists to list all output queues. DSPEMTOUTQ can
be helpful in cleaning up unused output queues.
You must have *ALLOBJ special authority to use a library value of
*ALL or *ALLUSR.
A typical command would be:
DSPEMTOUTQ OUTQ(*ALL/*ALL) FLAGDAYS(100)
All output queues in all libraries that do not have any entries would
be listed. Any output queues that have not been used in the last 100
days would be flagged.
DSPEMTOUTQ escape messages you can monitor for
----------------------------------------------
None. Escape messages from based on functions will be re-sent.
DSPEMTOUTQ Command parameters *CMD
-----------------------------
OUTQ The qualified name of the output queue to be be
processed. A single output queue, a generic name,
or the special value *ALL may be entered.
The library value defaults to *LIBL. A specific
library, *CURLIB, *USRLIBL, *ALL, or *ALLUSR may be
entered.
FLAGDAYS The number of days to flag the output queue if it
has not been used. The default is 60 days. The
value must be in a range of 0-999.
An output queue is considered used if a spooled file
was added to the queue. Using a value provides a
better indication of what is being used.
ALLOUTQ Whether to list all output queues regardless of the
number of spooled files that exist.
*NO is the default to list only output queues with
no spooled files.
*YES may be specified to list all output queues.
OUTPUT How to output the results. * is the default to
display the spooled file if the command is entered
interactively. The spooled file is deleted after it
is displayed.
If the command is entered in batch or *PRINT is
specified, the spooled file is output and retained.
Restrictions
------------
You must have *ALLOBJ special authority to use a library value of
*ALL or *ALLUSR.
Prerequisites
-------------
The following TAA Tools must be on your system:
ADDDAT2 Add date 2
CHKALLOBJ Check *ALLOBJ special authority
EDTVAR Edit variable
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
------ ---- --------- ---------- ----------
DSPEMTOUTQ *CMD TAASPPD QATTCMD
TAASPPDC *PGM CLP TAASPPDC QATTCL
TAASPPDR *PGM RPG TAASPPDR QATTRPG
|
Added to TAA Productivity tools October 15, 2010