The Check Minimum Release command finds objects that were created
with a target release earlier than the one specified on the command
and determines if the source still exists. *PGM, *MODULE, and
*SRVPGM objects are checked. All *SQLPKG objects are flagged.
Objects with creation data may be bypassed. The companion tool to
re-create the objects is FIXMINRLS. 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. If LIB(*ALL) or LIB(*ALLUSR) is used, any IASPs
must be available unless CHKIASP(*NO) is specified.
A typical command would be:
CHKMINRLS 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, the object would be flagged. Any objects created on or after
V5R1M0 would not appear in the listing.
The source for the object would be checked to see if it exists and
flagged if it does not.
All *SQLPKG objects are flagged.
DFU and Query programs are treated as normal programs. They are
bypassed by the target release or creation data criteria if met. If
not, they are flagged.
Either CHKMINRLS or FIXMINRLS may be run as often as needed on the
same library.
CHKMINRLS escape messages you can monitor for
---------------------------------------------
TAA9891 No object types found to process.
Escape messages from based on functions will be re-sent.
CHKMINRLS Command parameters *CMD
----------------------------
LIB A list of up to 300 libraries or generic libraries
to be checked. The special values *ALL, *ALLUSR, or
*USRLIBL may be used. An entry of *ALLUSR bypasses
the system library QSYS2 which is described as a
'user' library on SAVLIB.
DSPOBJD is used to access the libraries with
ASPDEV(*ALLAVL) specified.
OMITLIB A list of up to 300 libraries or generic libraries
to be omitted. The default is *NONE meaning all
libraries from the LIB parameter will be checked.
Entering a library may be helpful if a special value
such as *ALLUSR is used for the LIB parameter and
you want to bypass the checking of certain
libraries.
MINRLS The minimum release to check against the objects.
The default is V5R1M0.
The value must be in the form VnRnMn and must match
one of those in the list when the command prompter
is used. 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.
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.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKALLOBJ Check *ALLOBJ special authority
CHKIASP Check IASP status
CHKGENERC Check generic
CHKGENOBJ Check generic object
CHKIASP Check IASP
CHKOBJ3 Check object 3
CVTLIBOBJD Convert library object description
EXTLST Extract list
EXTLST2 Extract list 2
RSNLSTMSG Resend last message
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
SNDSTSCNT Send status count
SNDSTSMSG Send status message
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
CHKMINRLS *CMD TAAPGNU QATTCMD
TAAPGNUC *PGM CLP TAAPGNUC QATTCL
TAAPGNUC11 *PGM CLP TAAPGNUC11 QATTCL
TAAPGNUR *PGM RPG TAAPGNUR QATTRPG
Structure
---------
CHKMINRLS Cmd
TAAPGNUC CL pgm Main program - Creates list of objects
TAAPGNUC11 CL pgm Checks objects
TAAPGNUR RPG pgm Prints
|
