TAA Tools

The  Create Target  Release  command assists  in  creating or  changing
objects  to  be saved  for  a named  release.   A  specific  or generic
object  is named  or all objects  in a library.   Either  a new library
must be named and  must not exist (it  is created by CRTTGTRLS) or  the
objects  in the same  library will  be created  for the  named release.
The  TAA Tool  RPLOBJ is  used to recreate  program and  module objects
and produces a listing of the results.

You must have *ALLOBJ special authority to use CRTTGTRLS.

A typical command would be:


The ABC2  library  must not  exist  and would  be  created.   The  text
description would  be the  same as  the From library.   All  objects in
ABC would  be duplicated to ABC2 including any  data.  All objects that
allow a TGTRLS value (*MODULE and  *PGM) would be re-created using  the
source  member  that  created  each  object.    Any  objects  that  are
required for  a create (commands, data areas,  /COPY objects, etc) must
exist  on  the  library  list  when the  command  runs.    *MODULES are
created first.  The target release would be specified as *PRV.

A listing would exist  of the results from  the sub tool RPLOBJ.   Only
the *MODULE  and *PGM  objects would  be listed.   If some  objects did
not create successfully, they must be handled manually.

RPLOBJ  uses   the  source  file/library/member  information  from  the
object to re-create the  object.  Therefore, the  source does not  have
to be in the same library as the object being created.

The library  is then  ready to  be saved  to the  previous release  and
sent to the another system.

*FILE  and  *CMD  object  types  which  are  created  from  source  are
duplicated by CRTDUPOBJ and not re-created  because they do not have  a
TGTRLS parameter.

Another typical example, would be:


The program and module  objects in library ABC would  be re-created for
the previous release.

Reasons for failures to recreate

There  are  several reasons  that  modules and  programs  could not  be
re-created such as:

  **   The  source used to  create the object does  not exist where the
       object was created from.

  **   Objects that are  required for a  create (commands, data  areas,
       /COPY  objects, etc)  must exist  on the  library list  when the
       command runs.

  **   The  object does  not contain the  source information.   This is
       typical of multi-module  programs where the  modules exist in  a
       library other  than the From library.   If the modules  exist in
       the  From  library along  with  the source  for  them,  both the
       modules and the program  would normally be re-created  properly.

CRTTGTRLS escape messages you can monitor for

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

CRTTGTRLS Command parameters                          *CMD

   FROMLIB       The From library  containing the objects that  will be

   TOLIB         The  TO   library  where  the  new   objects  will  be
                 created.   If a  specific library is  named (it cannot
                 be the  same as  the From library),  the library  must
                 not exist and will be created by CRTTGTRLS.

                 The special  value *FROMLIB  may be used  to re-create
                 the  module and program  objects in  the From library.
                 When TOLIB(*FROMLIB)  is used,  the defaults  must  be
                 used  for  SRCLIB  and TOLIBTEXT.    Both  values  are

   OBJ           The  object or  generic object name  to create.   *ALL
                 is the default  for all  *PGM and  *MODULE objects  in
                 the From library.

   TGTRLS        The  target  release  of the  programs  that  will  be
                 replaced.   This is the same value  as used on several
                 CRT  program commands  and is  passed thru  to the CRT

                 *PRV is  the default.    Use the  command prompter  to
                 see  the  specific  release  names that  may  also  be

   GENLVL        The    generation   severity   level   specifies   the
                 diagnostic-message severity  level at  which  creation
                 of a program or module stops.

                 *DFT  is  the default  which  is  passed thru  to  the
                 CRTRPGxxx  or CRTCBLxxx  commands  to use  the default
                 supplied by the compilers.

                 A specific  value between  1 and  50 may  be  entered,
                 but see the specific command for a narrower range.

   SRCLIB        The  source library  used for  the  create of  objects
                 created from source.

                 *FROMOBJ  is the  default meaning  the  source library
                 used  to  create the  object  as found  in  the object

                 *TOLIB may  be specified  to mean  the source  library
                 of  the  To  Library.    This assumes  that  the  From
                 Library  contains the source files  used to create the
                 objects.    This  causes   a  change  to  the   object
                 descriptions  of the  From  library  *MODULE and  *PGM
                 objects  so that  the source  library reflects  the To
                 library.  This  change occurs before  the *MODULE  and
                 *PGM objects are re-created.

                 Assume the  following: 1) You  have library  ABC which
                 should  be  sent  to  another  system  which is  at  a
                 previous  release.   2) The ABC  library also contains
                 the  source  files  that  were  used  to   create  the
                 objects.   3) You  want to use  CRTTGTRLS to  create a
                 new  library ABC2 which would  contain the ABC objects
                 and can be saved to  a previous release.  4) You  want
                 to restore  the ABC2 library  on the other  system and
                 use   the  original   library  name  of   ABC  (RSTLIB
                 SAVLIB(ABC2) RSTLIB(ABC)).   In  this case,  you  want
                 to take the  default of SRCLIB(*FROMOBJ) so  that when
                 the  restore occurs,  the  objects will  appear  to be
                 created  from the  source files  that exist  in ABC on
                 the system where the restore occurred,

   TOLIBTEXT     The  text   description   of  the   new  To   library.
                 *FROMLIB is  the default meaning to use  the same text
                 description as exists for the From library.


You must have *ALLOBJ special authority to use CRTTGTRLS.

The  source must exist in the same  location where the *PGM and *MODULE
objects were created from.

Objects that are  required for  a create (commands,  data areas,  /COPY
objects, etc) must exist on the library list when the command runs.


The following TAA Tools must be on your system:

     CHKALLOBJ       Check *ALLOBJ special authority
     EDTVAR          Edit variable
     RPLOBJ          Replace object
     RTVPRVRLS       Retrieve previous release
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message


None, the tool is ready to use.

Objects used by the tool

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

   CRTTGTRLS     *CMD                   TAALIDK       QATTCMD
   TAALIDKC      *PGM       CLP         TAALIDKC      QATTCL
   TAALIDKC2     *PGM       CLP         TAALIDKC2     QATTCL

Added to TAA Productivity tools October 15, 2010

Home Page Up to Top