TAA Tools
CMPMSGQA        COMPARE MESSAGE QUEUE ATTRIBUTES       TAAMSIZ

The Compare  Message Queue Attributes  command compares  the attributes
of  two  Message Queue  objects.   A  spooled  file is  created  of any
differences.

The major attributes which are not compared are:

      - Owner
      - Authorizations
      - Text description
      - Create date and time

A typical command would be:

             CMPMSGQA  FROMMSGQ(xxx) TOMSGQ(yyy)

A spooled file would be created with any differences shown.

An  option exists to send  an escape message if  differences exist.  An
option exists to delete the spooled file if no differences exist.

The owner and authorizations are not compared.

CMPMSGQA escape messages you can monitor for
--------------------------------------------

      TAA9895    Differences exist (optional based on ESCAPE parm)

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

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

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

   TOMSGQ        The  qualified  name of  the  To Message  Queue  to be
                 compared.  The default  is *FROMMSGQ meaning the  same
                 Message  Queue  name  as in  the  FROMMSGQ  parameter.
                 The library  value defaults to blanks.   If no name is
                 entered, *LIBL  is  assumed.    *CURLIB  may  also  be
                 used.

   ESCAPE        Whether  to  send an  escape  message  if  differences
                 exist.   The default is  *NO which means  a completion
                 message is sent.

                 *YES  may be specified to  send TAA9895 if differences
                 exist.

   DLTSPLF       Whether to  delete the  spooled file if  there are  no
                 differences.     The  default  is   *YES  meaning  the
                 spooled  file is deleted if  no differences are found.
                 The spooled  file is  always retained  if  differences
                 exist.

                 *NO may  be specified  to ensure  a spooled file  will
                 exist  regardless  of  whether  differences  exist  or
                 not.


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

None.

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

The following TAA Tools must be on your system:

     CHKOBJ3         Check object 3
     EDTVAR          Edit variable
     RSNLSTMSG       Resend last message
     RTVMSGQA        Retrieve message queue attributes
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message

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

None, the tool is ready to use.

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

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

   CMPMSGQA      *CMD                   TAAMSJA       QATTCMD
   TAAMSJAC      *PGM       CLP         TAAMSJAC      QATTCL
   TAAMSJAR      *PGM       RPG         TAAMSJAR      QATTRPG
					

Added to TAA Productivity tools January 1, 2008


Home Page Up to Top