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