DLTMSGQMSG      DELETE MESSAGE QUEUE MESSAGES          TAAMSIU

 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

Added to TAA Productivity Tools November 15, 2005


Home Page

Powered by AS/400Powered by AS/400 Last modified on July 15, 2010 © 1995, 2010 - Jim Sloan, Inc.