FIXMINRLS FIX MINIMUM RELEASE TAAPGNV |
The Fix Minimum Release command finds objects that were created with
a target release earlier than the one specified on the command and
replaces the object for most cases. *PGM, *MODULE, and *SRVPGM
objects are checked. *MODULE and single module *PGM objects are
replaced. Objects with creation data may be bypassed. All *SQLPKG
objects are flagged. The companion tool to check the objects is
CHKMINRLS. The tool is designed to assist in conversion to V6R1M0.
You must have *ALLOBJ special authority to specify a LIB value of
*ALL or *ALLUSR and any IASPs must be available unless CHKIASP(*NO)
is specified.
A typical command would be:
FIXMINRLS LIB(xxx) MINRLS(V5R1M0) BYPCRTDTA(*YES)
All object types *PGM, *MODULE, and *SRVPGM in the library would be
found. The minimum release value would be compared to the MINRLS
value on the command. If the object minimum release is less than
(such as a V4R4M0 release) and the object does not have creation
data, *MODULE and single module *PGM objects would be re-created.
The source must exist where the object was originally created from.
Any objects created on or after V5R1M0 would not appear in the
listing.
All *SQLPKG objects are flagged.
DFU and Query programs are treated as normal programs.
*SRVPGM and multi-module programs are flagged.
Re-creation of programs is done using the TAA RPLPGM command and
modules by the RPLMOD command. These commands determine the
libraries of any externally described files in the program/module and
temporarily add the libraries to the current library list during the
CRT command.
Either CHKMINRLS or FIXMINRLS may be run as often as needed on the
same library.
FIXMINRLS escape messages you can monitor for
---------------------------------------------
TAA9891 No object types found to process.
Escape messages from based on functions will be re-sent.
FIXMINRLS Command parameters *CMD
----------------------------
LIB The library to be checked. A specific library or
the special values *ALL, *ALLUSR, or *USRLIBL may
also be used. If *ALLUSR is specified, the QSYS2
library objects are bypassed.
DSPOBJD is used to access the libraries with
ASPDEV(*ALLAVL) specified.
MINRLS The minimum release to check against the objects.
The value must be in the form VnRnMn. Any object
with a minimum release earlier than the one
specified is flagged unless bypassed by the
BYPCRTDTA parameter.
BYPCRTDTA A *YES/*NO parameter for whether to bypass the
objects where 'creation data' exists.'
*YES is the default to bypass such objects. When
'creation data' exists, the system can re-create the
object when required.
*NO may be specified to check such objects.
DLTSPLF A *YES/*NO parameter for whether to delete CRTxxx
compiler listings if the create was successful.
*YES is the default. Any CRTxxx commands that fail
always have the listing retained.
*NO may be specified to retain any CRTxxx command
listings.
OUTPUT How to output the results. * is the default to
display the spooled file if the command is entered
interactively. The spooled file is deleted after it
is displayed.
If the command is entered in batch or *PRINT is
specified, the spooled file is output and retained.
CHKIASP Whether to check for IASP availability if LIB(*ALL)
or LIB(*ALLUSR) is specified.
*YES is the default meaning that all IASPs must be
available.
*NO may be specified to bypass the check.
Restrictions
------------
** Only *PGM, *MODULE, and *SRVPGM object types are checked for
source.
** *SQLPKG object types are just listed.
** You must have *ALLOBJ special authority to specify a LIB value
of *ALL or *ALLUSR.
** You must have *ALL rights to an object to replace it.
** The source must exist where the object was originally created
from.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKALLOBJ Check *ALLOBJ special authority
CHKOBJ3 Check object 3
RPLMOD Replace module
RPLPGM Replace program
RTVMODA Retrieve module attributes
RTVPGMA Retrieve program attributes
RTVSRVPGMA Retrieve service program attributes
RTVSYSVAL3 Retrieve system value 3
SNDCOMPMSG Send completion message
SNDESCINF Send escape information
SNDESCMSG Send escape message
SNDSTSMSG Send status message
SNDSTSCNT Send status count
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
FIXMINRLS *CMD TAAPGNV QATTCMD
TAAPGNVC *PGM CLP TAAPGNVC QATTCL
TAAPGNVR *PGM RPG TAAPGNVR QATTRPG
|
Added to TAA Productivity tools September 15, 2007