TAA Tools

The Compare Data  Queue Entries command  compares the entries  and keys
(if any)  for two data queues.   The intent of the command  is to allow
a  comparison when two data  queues should have the  same entries.  For
example, if  a data queue  is being  processed with remote  journaling,
you  may want to  compare the  data queues  from two  different systems
(see later comments).

A typical command would be:

             CMPDTAQE   FROMDTAQ(xxx) TODTAQ(yyy)

The  data  queues  must be  defined  the same  for  sequence  (keyed or
non-keyed), maximum entry length, key  length, sender ID, and have  the
same number of  entries.  Only the  entry data (max of  9000 bytes) and
the  key (if  any) are  compared.  The  time and  date the  entries are
sent is not compared.

A spooled file is output with the results.

Comparing data queues on two different systems

Data queue entries  are not saved  when a data queue  object is  saved.
Consequently, you cannot save  a data queue, transfer the  saved object
to a second system and make a comparison.

However, with the following steps, you can make a comparison:

  **   Use  the TAA  tool CVTDTAQ on  the 'from'  system to  create the
       DTAQP file.

  **   Transfer the DTAQP file to the 'to' system.

  **   Create  an  identical  data  queue  on  the  'to'  system  in  a
       separate library.

  **   Use the  TAA tool  CPYBCKDTAQ to  convert the  entries from  the
       DTAQP file to the identical data queue.

  **   Use the CMPDTAQE command.

CMPDTAQE escape messages you can monitor for

      TAA9893    The entries (and or keys) do not match

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

Command parameters                                    *CMD

   FROMDTAQ      The  qualified name  of the  'from' data  queue  to be
                 compared.    The  library  value  defaults  to  *LIBL.
                 *CURLIB may also be used.

   TODTAQ        The qualified  name  of  the  'to' data  queue  to  be
                 compared.    The  library  value  defaults  to  *LIBL.
                 *CURLIB may also be used.


The maximum entry length which may be compared is 9000 bytes.


The following TAA Tools must be on your system:

     CHKOBJ3         Check object 3
     CVTDTAQ         Convert data queue
     EDTVAR          Edit variable
     RTVDTAQD        Retrieve data queue description
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCMSG       Send escape message
     SNDSTSMSG       Send status message


None, the tool is ready to use.

Objects used by the tool

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

   CMPDTAQE      *CMD                   TAADTQN       QATTCMD
   TAADTQNC      *PGM       CLP         TAADTQNC      QATTCL
   TAADTQNR      *PGM       RPG         TAADTQNR      QATTRPG

Added to TAA Productivity tools December 15, 2002

Home Page Up to Top