The Replace Module command  re-creates an existing module.   The intent
of  RPLMOD  is to  provide  a  simple re-create  when  only the  source
statements have been changed.

A typical command would be entered as:

       RPLMOD   MODULE(xxxxxx)

RPLMOD  extracts the  libraries specified for  any externally described
files used  in the program  (if not  already on the  library list)  and
adds them to  the current library list when  the program is re-created.
The same libraries are then removed.

RPLMOD   extracts  some  existing   parameters  from   the  object  and
re-creates  the  object.    The  source  file/library/member  from  the
object  is used  unless specified  on  the command.   REPLACE(*YES)  is
specified  on the create command  which will place the  old object into
the QRPLOBJ  library,  copy  the authorizations  and  re-establish  the
values of  USRPRF and  USEADPAUT.   The TEXT parameter  value is  taken
from the source member and not the existing object.

The RTVMODA  TAA Tool which  uses the QBNRMODI  API is used  to extract
the  existing  attributes.    Because  the  API  does  not  provide for
options like  the  type of  debug  data stored  in  the object,  RPLMOD
cannot replace an object with all existing attributes.

Error messages you may wish to monitor for are:

      TAA9895    A supported source type does not have the
                    corresponding create command on the system

      TAA9896    An unknown or unsupported source type exists

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

   MODULE        The  qualified  name of  the  module  to be  replaced.
                 The library defaults to *LIBL.

   SRCFILE       The  qualified name  of  the source  file to  be used.
                 The default is *OBJD meaning  to use the same file  as
                 is  specified in  the object  description (the  source
                 file originally used).

   SRCMBR        The  source member to be  used.  The  default is *OBJD
                 which means  to  use  the same  source  member  as  is
                 specified  in  the  object   description  (the  source
                 member originally used).

   GENLVL        The   generation    severity   level   specifies   the
                 diagnostic-message  severity  level at  which creation
                 of the module stops.

                 *DFT is  the  default  which  is passed  thru  to  the
                 CRTRPGMOD  or CRTCBLMOD  commands to  use the  default
                 supplied by the compilers.

                 A  specific value  between  1 and  50 may  be entered,
                 but see the specific command for a narrower range.

   TGTRLS        The  target  release  of  the  module  that   will  be
                 created.   This is the same  value as used  on several
                 CRT  module commands  and is  passed  thru to  the CRT
                 command.

                 *CURRENT is  the  default.   *PRV  may  be  specified.
                 Use the command  prompter to see the  specific release
                 names that may also be entered.

   OWNER         Who  should  be the  owner  of the  new  module.   The
                 default  is *SAME, meaning the  same owner will exist.

                 If the  owner  is the  group  profile of  the  current
                 user, OWNER(*SAME)  may be used.   Otherwise, you must
                 be  the  owner or  have *ALLOBJ  special  authority to
                 use OWNER(*SAME).

                 *NEW may  be  specified to  allow  you to  become  the
                 owner  of the  module.   You must  have the  *OBJEXIST
                 right to the existing module to specify *NEW.

   DLTSPLF       A  *YES/*NO  parameter for  whether  the  spooled file
                 for the  compiler listing  should  be deleted  if  the
                 create  is successful.   *NO  is  the default  meaning
                 the spooled file is always retained.

                 *YES may  be specified to  delete the spooled  file if
                 the create is successful.

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

Only the following module types are supported:

      CLE
      CLLE
      CBLLE
      RPGLE

Many  of  the parameters  that may  be specified  on the  Create Module
command  are not  returned  by  the  retrieve API  used  and  therefore
cannot be re-created in the new object.

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

The following TAA Tools must be on your system:

      CHKALLOBJ     Check all object authority
      RTVMODA       Retrieve module attributes
      RTVPGMREFL    Retrieve program reference libraries
      SNDCOMPMSG    Send completion message
      SNDDIAGMSG    Send diagnostic message
      SNDESCMSG     Send escape message
      SNDSTSMSG     Send status message

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

None, the tool is ready to use.

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

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

   RPLMOD        *CMD                      TAAMODB        QATTCMD
   TAAMODBC      *PGM          CLP         TAAMODBC       QATTCL