CHKTGTRLS CHECK TARGET RELEASE TAAPGMV
The Check Target Release command checks the programs in a library to
determine if they were created for a release that is more current
than the minimum release specified on the command. Modules and
service programs are also checked. The intent of the tool is to
check a library prior to a save where the TGTRLS parameter is to be
used because the SAVLIB command will not treat the condition as an
error in all cases.
A typical command would be:
CHKTGTRLS LIB(xxx) TGTRLS(VnRnMn)
The programs, modules, and service programs in the library would be
found and the minimum release of each would be compared against the
TGTRLS value. If one of the objects was created for a release that
was more current than the TGTRLS value, the object would be listed in
the spooled output and an escape message would occur.
For example, if you are now on release V4R1M0 and specify
TGTRLS(V3R7M0), any programs created for the V4R1M0 release would be
detected and appear on the listing. To properly save programs for a
release other than the current release, you must create programs with
the TGTRLS parameter.
The TGTRLS parameter only supports the prior releases that are valid
on the SAV commands of the current release. The current release is
not supported because no exceptions would be found.
Command parameters *CMD
LIB The library containing the programs, modules and
service programs to be checked.
TGTRLS The target release to be checked for. Any programs,
modules, or service programs created on a more
current release will appear in the spooled output.
Because the SAV commands do not support all prior
releases, the valid values on the SAV commands may
change on each release. Therefore, the supported
values for MINRLS may change on each release.
ESCMSG A *YES/*NO parameter that determines if you will
receive an escape message if any error conditions
are found. The default is *YES.
*NO may be specified to cause a completion message
that contains a count of any target release error
The following TAA Tools must be on your system:
RTVMODA Retrieve module attributes
RTVPGMA Retrieve program attributes
RTVPRVRLS Retrieve previous release
RTVSRVPGMA Retrieve service program attributes
RTVSYSVAL3 Retrieve system value 3
SNDCOMPMSG Send completion message
SNDESCMSG Send escape message
None, the tool is ready to use.
Objects used by the tool
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
CHKTGTRLS *CMD TAAPGMV QATTCMD
TAAPGMVC *PGM CLP TAAPGMVC QATTCL
TAAPGMVR *PGM RPG TAAPGMVR QATTRPG
Added to TAA Productivity tools November 1, 1997