RPLGENPGM REPLACE GENERIC PROGRAMS TAAPGMT
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:
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
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
*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
*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.
The RPLPGM command used to re-create has some restrictions.
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
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
Added to TAA Productivity tools August 1, 1997