The  Move Message  Description  command  moves  one, a  range,  or  all
message  descriptions from one  message file  to another.   Any message
IDs  that are moved are removed from the  From message file.  A listing
is displayed or output of  all messages moved and any errors  that have
occurred.

A typical command would be:

             MOVMSGD   FROMMSGF(ABC) TOMSGF(DEF) RANGE(XYZ1234)

Because the second  part of the RANGE parameter  defaults to *ONLY, the
XYZ1234  message ID  would be moved  from the  ABC message  file to the
DEF message  file.   The  message  ID would  be  removed from  the  ABC
message file.

You may also move a range of messages such as:

             MOVMSGD   FROMMSGF(ABC) TOMSGF(DEF)
                         RANGE(AAA1000 CCC7777)

The message  IDs in the  RANGE do not have  to exist unless  unless the
RANGE names a specific ID and *ONLY.

If  the message ID  to be moved  already exists in  the To  file, it is
flagged.

MOVMSGD escape messages you can monitor for
-------------------------------------------

      TAA9891    No message IDs in the specified range
      TAA9892    Some error occurred.
                   Only occurs if a listing is output

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

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

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

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

   RANGE         The range of message  IDs to be converted.   The first
                 part is the  low range.  A message  ID must be entered
                 or the special value *FIRST.

                 The  second part is  the upper range.   The default is
                 *ONLY meaning only  one message ID will  be moved.   A
                 specific  message ID  may be  entered  or the  special
                 value  *LAST meaning the  last message  in the message
                 file.

                 If message  IDs  are  entered, they  do  not  have  to
                 exist, but  act only as  a lower and  upper threshold.

                 If  a message  ID is  successfully  moved, it  will be
                 removed from the From message file.

   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 it is ended  with F3/F12 or the Enter
                 key.   To retain  the spooled  file, you  may use  the
                 the System  Request 'Cancel' function and  the spooled
                 file will exist in a HLD status.

                 If  the  command  is entered  in  batch  or *PRINT  is
                 specified, the spooled  file is  output and  retained.


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

None.

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

The following TAA Tools must be on your system:

     CHKMSGID        Check message ID
     CHKOBJ3         Check object 3
     CVTMSGF         Convert message file
     DUPMSGD         Duplicate message description
     EDTVAR          Edit variable
     RSNLSTMSG       Resend last message
     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
   ------        ----    ---------      ----------    ----------

   MOVMSGD       *CMD                   TAAMSKA       QATTCMD
   TAAMSKAC      *PGM       CLP         TAAMSKAC      QATTCL
   TAAMSKAC2     *PGM       CLP         TAAMSKAC2     QATTCL
   TAAMSKAR      *PGM       RPG         TAAMSKAR      QATTRPG