TAA Tools

 FIXMINRLS       FIX MINIMUM RELEASE                    TAAPGNV

 The Fix Minimum  Release command finds  objects that were  created with
 a  target release  earlier than the  one specified  on the  command and
 replaces  the  object  for  most cases.    *PGM,  *MODULE,  and *SRVPGM
 objects are  checked.    *MODULE and  single  module *PGM  objects  are
 replaced.   Objects with  creation data may  be bypassed.   All *SQLPKG
 objects  are  flagged.   The  companion tool  to check  the  objects is
 CHKMINRLS.  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 and  any IASPs must  be available  unless CHKIASP(*NO)
 is specified.

 A typical command would be:

              FIXMINRLS  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,  *MODULE  and single  module  *PGM objects  would  be re-created.
 The source must exist where the object was originally created from.

 Any  objects created  on  or  after  V5R1M0  would not  appear  in  the
 listing.

 All *SQLPKG objects are flagged.

 DFU and Query programs are treated as normal programs.

 *SRVPGM and multi-module programs are flagged.

 Re-creation  of programs  is  done  using the  TAA  RPLPGM command  and
 modules   by  the  RPLMOD  command.     These  commands  determine  the
 libraries of any externally described  files in the program/module  and
 temporarily add  the libraries to the  current library list  during the
 CRT command.

 Either  CHKMINRLS or  FIXMINRLS may be  run as  often as needed  on the
 same library.

 FIXMINRLS escape messages you can monitor for
 ---------------------------------------------

       TAA9891    No object types found to process.

 Escape messages from based on functions will be re-sent.

 FIXMINRLS Command parameters                          *CMD
 ----------------------------

    LIB           The library  to be  checked.   A specific  library  or
                  the  special values  *ALL,  *ALLUSR, or  *USRLIBL  may
                  also  be used.   If  *ALLUSR  is specified,  the QSYS2
                  library objects are bypassed.

                  DSPOBJD   is  used   to  access   the  libraries  with
                  ASPDEV(*ALLAVL) specified.

    MINRLS        The minimum  release  to  check against  the  objects.
                  The  value must  be in  the form  VnRnMn.   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.

    DLTSPLF       A  *YES/*NO parameter  for  whether to  delete  CRTxxx
                  compiler listings if the create was successful.

                  *YES is  the default.   Any CRTxxx commands  that fail
                  always have the listing retained.

                  *NO  may  be specified  to  retain any  CRTxxx command
                  listings.

    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.

   **   You must have *ALL rights to an object to replace it.

   **   The  source must exist  where the object  was originally created
        from.

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

 The following TAA Tools must be on your system:

      CHKALLOBJ       Check *ALLOBJ special authority
      CHKOBJ3         Check object 3
      RPLMOD          Replace module
      RPLPGM          Replace program
      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
      SNDSTSMSG       Send status message
      SNDSTSCNT       Send status count

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

 None, the tool is ready to use.

 Objects used by the tool
 ------------------------

    Object        Type    Attribute      Src member    Src file
    ------        ----    ---------      ----------    ----------

    FIXMINRLS     *CMD                   TAAPGNV       QATTCMD
    TAAPGNVC      *PGM       CLP         TAAPGNVC      QATTCL
    TAAPGNVR      *PGM       RPG         TAAPGNVR      QATTRPG

Added to TAA Productivity Tools September 15, 2007


Home Page

Last modified on November 19, 2014 © 1995, 2014 - TAA Tools, Inc.