TAA Tools
CHKMINRLS       CHECK MINIMUM RELEASE                  TAAPGNU

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
					

Added to TAA Productivity tools September 15, 2007


Home Page Up to Top