TAA Tools
CLRDTAQ         CLEAR DATA QUEUE                       TAADTQH

The Clear  Data  Queue command  clears a  non-keyed data  queue of  all
entries.   A keyed data queue may  be cleared of a specific  key or all
entries.  The command uses the API QCLRDTAQ.

A typical command would be:

             CLRDTAQ    DTAQ(xxx)

Any existing entries in the data queue would be cleared.

A  keyed data queue may only be cleared  for the entries that match the
specified key.    If KEYORD(GT)  is  specified with  a blank  key,  the
entire data queue is cleared.

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

   DTAQ          The qualified  name of the  data queue to  be cleared.
                 The  library  value defaults  to *LIBL.    *CURLIB may
                 also be used.

   KEYED         A  *YES/*NO  value  for  whether  the  data  queue  is
                 keyed.  The default is *NO.

                 If *YES  is entered,  the KEYORD, KEYLEN,  and KEYDATA
                 parameters  must be entered.   A keyed  data queue may
                 only  be  cleared  for  the  entries  that  match  the
                 specified  key.   If KEYORD(GT)  is  specified with  a
                 blank key, the entire data queue is cleared.

   KEYORD        The  order  of the  key  field.   The  default is  EQ.
                 Other  values that may be entered  are GT, LT, NE, GE,
                 or LE.

   KEYLEN        The length  of the  key  field.   It must  be a  value
                 between 1 and 255.

   KEYDATA       The key to be cleared.

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

None.

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

The following TAA Tools must be on your system:

     SNDCOMPMSG      Send completion message
     SNDESCMSG       Send escape message

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

None, the tool is ready to use.

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

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

   CLRDTAQ       *CMD                   TAADTQH       QATTCMD
   TAADTQHC      *PGM       CLP         TAADTQHC      QATTCL
					

Added to TAA Productivity tools November 1, 1997


Home Page Up to Top