TAA Tools
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


Home Page Up to Top