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

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