The Delete  Message Queue  Messages command  is an  alternative to  the
RMVMSGQMSG command.   DLTMSGQMSG is intended to be  used when there are
too  many  messages  in a  message  queue  for RMVMSGQMSG  to  be used.
DLTMSGQMSG uses a  different technique than  RMVMSGQMSG.  Messages  may
be deleted by a count or within a date range or both.

A typical command would be:

            DLTMSGQMSG    MSGQ(xxx) DLTCNT(10000)
                            FROMDATE(nnnnnn) TODATE(nnnnnn)

Up to  100,000 messages would be  deleted from the  named message queue
between the range of dates.

DLTMSGQMSG escape messages you can monitor for
----------------------------------------------

      TAA9891    No messages exist in the message queue.

Escape messages from based on functions will be re-sent.

Command parameters                                    *CMD
------------------

   MSGQ          The  qualified  name of  the message  queue  to delete
                 messages from.  The  library value defaults to  *LIBL.
                 *CURLIB may also be used.

   DLTCNT        The maximum  number of  messages to  be deleted.   The
                 value must be between 1 and 100,000.

                 If  you want to  delete all messages,  use the CLRMSGQ
                 command.

   FROMDATE      The From date  to begin deleting  messages from.   The
                 default   is   *BEGIN  meaning   the   earliest   date
                 possible.   If a  date is entered,  it must be  in job
                 format.

                 FROMDATE  and TODATE  describe a  date range.   If the
                 date the  message was  sent is within  the range,  the
                 message is  considered for  deletion until  the DLTCNT
                 is met.

   TODATE        The  To date  to end  deleting messages.   The default
                 is *END meaning the most  current date.  If a date  is
                 entered, it must be in job format.

                 FROMDATE and  TODATE describe  a date  range.  If  the
                 date  the message  was sent is  within the  range, the
                 message is considered  for deletion  until the  DLTCNT
                 is met.

Restrictions
------------

None.

Prerequisites
-------------

The following TAA Tools must be on your system:

     EDTVAR          Edit variable
     RTVMSGQA        Retrieve message queue attributes
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message
     SNDSTSCNT       Send status count

Implementation
--------------

None, the tool is ready to use.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   DLTMSGQMSG    *CMD                   TAAMSIU       QATTCMD
   TAAMSIUC      *PGM       CLP         TAAMSIUC      QATTCL