The  MOVM command  allows  moving  a member  from  one source  file  to
another.  An  option allows the member in the  TOFILE to be replaced if
it already exists.

Internally  the  CPYF and  RMVM commands  are  executed to  perform the
function.

While the  major  use  for this  function  is  with source  files,  the
command will  also operate on data  files.  However, the  format of the
two files must be identical to perform the function.

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

   FROMFILE      The  file name to  be moved from.   The special values
                 *CLP, *RPG  etc.    may  be entered  to  describe  the
                 standard  system  supplied  source file  names.    The
                 library  defaults  to  *LIBL.    *CURLIB  may also  be
                 specified.

   TOFILE        The file  name to  be moved  to.   The special  values
                 *CLP,  *RPG etc.    may  be  entered to  describe  the
                 standard  system  supplied  source  file names.    The
                 library   defaults  *LIBL.     *CURLIB   may  also  be
                 specified.

   FROMMBR       The member name to move from.

   TOMBR         The  member  name  to   move  to.    The   default  is
                 *FROMMBR.

   REPLACE       This  defaults  to *NO  meaning  the  member must  not
                 exist  in the  TOFILE.  A  *YES value  may be entered.
                 If *YES is  entered, the  member will  be replaced  if
                 it exists and is added if it does not exist.

   ALWLONGTO     A *YES/*NO  parameter for  whether to  allow the  move
                 to occur  if the To file has a  longer length.  If the
                 From file has  a longer  length, MOVM  cannot be  used
                 as truncation would occur.

                 *NO is  the  default to  prevent the  move  if the  To
                 file  has  a longer  length.    This protects  against
                 moving   the  member  to  a   file  where  the  format
                 differs.

                 *YES may  be  specified  to cause  the  internal  CPYF
                 command  to specify  FMTOPT(*MAP).    This allows  the
                 typical  example  of  moving  from  a  92  byte length
                 source file to 112 or greater.

A typical command would appear as follows:

     MOVM   FROMFILE(*RPG) TOFILE(PROD/*RPG) MBR(XXX)

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

The From file cannot have a longer length.

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

The following TAA Tools must be on your system:

        RTVDBFA        Retrieve data base file attributes
        SNDCOMPMSG     Send completion message
        SNDESCMSG      Send escape message

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

None, the tool is ready to use.

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

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

   MOVM          *CMD                      TAAMBRE        QATTCMD
   TAAMBREC      *PGM          CLP         TAAMBREC       QATTCL