The  Compare  Message  Queue  command  compares  the  message  text  of
messages  in two  different message  queues.   The  first 256  bytes of
each  message are  compared and  any differences  are flagged.   If you
are using  message queues  for an  application where  the messages  are
data  rather  than  text,  CMPMSGQ  may be  helpful  when  a  duplicate
message queue is required.

A typical command would be:

             CMPMSGQ    FROMMSGQ(xxx) TOMSGQ(yyy)

The  messages  in  each  message  queue  are  converted  and  compared.
Differences are noted.   If one  message queue has  more messages  than
the other message queue, the additional messages are listed.

CMPMSGQ escape messages you can monitor for
-------------------------------------------

      TAA9891    Differences exist (used for OUTPUT = *PRINT)

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

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

   FROMMSGQ      The qualified  name of  the From  message queue  to be
                 compared.   The  library value defaults  to *LIBL.   A
                 specific library or *CURLIB may also be used.

   TOMSGQ        The qualified  name  of the  To  message queue  to  be
                 compared.   The library  value defaults  to *LIBL.   A
                 specific library or *CURLIB may also be used.

   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
------------

Only the first 256 bytes are compared.

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

The following TAA Tools must be on your system:

     CHKOBJ3         Check object 3
     CVTMSGQ         Convert message queue
     RSNLSTMSG       Resend last message
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message
     SNDSTSMSG       Send status message

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

None, the tool is ready to use.

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

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

   CMPMSGQ       *CMD                   TAAMSJX       QATTCMD
   TAAMSJXC      *PGM       CLP         TAAMSJXC      QATTCL
   TAAMSJXR      *PGM       RPG         TAAMSJXR      QATTRPG