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

Last modified on March 10, 2014 © 1995, 2014 - TAA Tools, Inc.