DSPEMTJOBQ DISPLAY EMPTY JOB QUEUE TAAJOFL |
The Display Empty Job Queue command displays one or more job queues
that have no jobs. A flag may be set if the job queue has not been
used (such as not having any jobs added) in the last n days. An
option exists to list all job queues. DSPEMTJOBQ can be helpful in
cleaning up unused job queues.
You must have *ALLOBJ special authority to use a library value of
*ALL or *ALLUSR.
A typical command would be:
DSPEMTJOBQ JOBQ(*ALL/*ALL) FLAGDAYS(100)
All job queues in all libraries that do not have any jobs would be
listed. Any job queues that have not been used in the last 100 days
would be flagged.
DSPEMTJOBQ escape messages you can monitor for
----------------------------------------------
None. Escape messages from based on functions will be re-sent.
DSPEMTJOBQ Command parameters *CMD
-----------------------------
JOBQ The qualified name of the job queue to be be
processed. A single job 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 job queue if it has
not been used. The default is 60 days. The value
must be in a range of 0-999.
A job queue is considered used if a job was added to
the queue. Using a value provides a better
indication of what is being used.
ALLJOBQ Whether to list all job queues regardless of the
number of jobs that exist.
*NO is the default to list only job queues with no
jobs.
*YES may be specified to list all job 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
RTVJOBQA Retrieve job 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
------ ---- --------- ---------- ----------
DSPEMTJOBQ *CMD TAAJOFL QATTCMD
TAAJOFLC *PGM CLP TAAJOFLC QATTCL
TAAJOFLR *PGM RPG TAAJOFLR QATTRPG
|
Added to TAA Productivity tools October 15, 2010