The Copy Message Queue  command copies messages from one  message queue
to another.  Only *COMP, *DIAG, and *INFO message types are copied.

A typical command would be:

             CPYMSGQ       FROMMSGQ(xxx) TOMSGQ(yyy)

All  *COMP,  *DIAG,  and  *INFO  messages  would  be  copied  from  the
FROMMSGQ  to the  TOMSGQ.  By  default, any existing  messages would be
cleared first in the "to message queue".

CPYMSGQ escape messages you can monitor for
--------------------------------------------

      TAA9891    No messages of type *COMP, *DIAG, or *INFO exist

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

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

   FROMMSGQ      The  qualified name  of  the  message  queue  to  copy
                 messages from.   The library value  defaults to *LIBL.
                 *CURLIB may also be used.

   TOMSGQ        The  qualified  name  of  the  message  queue  to copy
                 messages to.   The  library value  defaults to  *LIBL.
                 *CURLIB may also be used.

   CLEAR         A  *YES/*NO   parameter  for  whether  to   clear  the
                 message  queue before  writing messages  to it.   *YES
                 is the default to clear the TO message queue.

                 *NO may  be  specified  to add  messages  to  the  "to
                 message queue".

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

None.

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

The following TAA Tools must be on your system:

     CHKOBJ3         Check object 3
     CVTMSGQ         Convert message queue
     CVTTOMSGQ       Convert to message queue
     EDTVAR          Edit variable
     RSNLSTMSG       Resend last message
     RTVMSGQA        Retrieve message queue attributes
     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
   ------        ----    ---------      ----------    ----------

   CPYMSGQ       *CMD                   TAAMSIQ       QATTCMD
   TAAMSIQC      *PGM       CLP         TAAMSIQC      QATTCL