TAA Tools
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
                 conditions found.

Restrictions
------------

None.

Prerequisites
-------------

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

Implementation
--------------

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


Home Page Up to Top