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 Up to Top