RPLMOD REPLACE MODULE TAAMODB
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 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
*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
*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.
Only the following module types are supported:
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.
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
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
Added to TAA Productivity tools January 1, 1998