The  Replace  Generic  Programs  command   allows  the  re-creation  of
generic programs  or all programs  in a library.   The TAA  Tool RPLPGM
is  used to re-create each program.   It retrieves many of the existing
attributes from  the  program  and  then re-creates  with  the  current
attributes.  By default, the same source member and file are used.

A typical command would be:

            RPLGENPGM    PGM(LIBA/XXX*)

The XXX  programs would be found  in LIBA and each  would be re-created
using  the source  member  name and  file that  was originally  used to
create  the program.    A  spooled  file  describes  each  program  and
whether the create was successful or not.

By default, the  owner remains the same.   Options exist to  change the
owner,  use a different  source file, change  observability, and change
the CRTCLPGM ALWRTVSRC parameter.

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

   PGM           The generic name of the  programs to be re-created  or
                 *ALL for  all programs  in the  library.  The  library
                 qualifier must be specified.

   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) of each program.

   ALWRTVSRC     Whether to  allow the  retrieve of CL  source if  a CL
                 program  is replaced.   The  default is  *SAME meaning
                 the current  attribute of  the program  for  ALWRTVSRC
                 is used.   *YES  or *NO may  be specified  to override
                 the current attribute.

   RMVOBS        How    the   observable    information    (the   debug
                 capability) should be handled.   *SAME is the  default
                 which means  the same as  the existing program.   *ALL
                 may   be   specified  to   make   the  program   fully
                 observable.    *NONE may  be  specified to  remove the
                 observability.

                 Note that you  cannot compress the observability  with
                 this option.   If  the program is  already compressed,
                 replacing    the   program   will   cause   the   full
                 observability to  be  re-created.   You must  use  the
                 CPROBJ  system command  or  consider  the use  of  the
                 SQZPGMSIZ TAA tool.

   TGTRLS        The  target  release  of  the  programs  that will  be
                 created.  This is  the same value  as used on  several
                 CRT program  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 program  object.
                 The  default is  *SAME,  meaning the  same owner  will
                 exist.   The  user  of the  command must  have *ALLOBJ
                 authority  to  change  the  owner  name  back  to  the
                 original owner.

                 *NEW  may  be  specified  to allow  the  user  of  the
                 command  to  become the  owner  of the  program.   The
                 user of the command must  have the *OBJEXIST right  to
                 the existing programs to specify *NEW.

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

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

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

The RPLPGM command used to re-create has some restrictions.

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

The following TAA Tools must be on your system:

     CHKALLOBJ       Check *ALLOBJ authority
     RPLPGM          Replace program
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion 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
   ------        ----    ---------      ----------    ----------

   RPLGENPGM     *CMD                   TAAPGMT       QATTCMD
   TAAPGMTC      *PGM       CLP         TAAPGMTC      QATTCL
   TAAPGMTR      *PGM       RPG         TAAPGMTR      QATTRPG