MRGOBJ -- Merge Objects

MRGOBJ MERGE OBJECTS TAALIBU
The Merge Objects command is intended for the case where you batch the changes that are to go into production. The command handles the merging in of normal objects, data base networks, and source members. Either new or replacement objects/members are handled. An option exists to retain or replace the production data. The command can be used on the same system or a remote system. The RPLDUPOBJ tool provides a command that may be considered for simple use. The MRGOBJ command is intended to work with the DUPCHGOBJ tool or your own function to place the new object versions in a separate library before merging them into production. The concept of MRGOBJ can be used in maintaining an application: On the same system (for example, you have a development library) On another system or systems in the same machine room. On remote systems. For example, assume you have a standard application that is on a development system and remote systems. Changes need to be made in certain objects. After testing the changes on the development system, you would first use the DUPCHGOBJ tool to duplicate the changed objects from the production library on the development system to a 'transfer' library. DUPCHGOBJ FROMLIB(PROD1) TOLIB(TFR) You would then transfer the library to the remote system either electronically or using save/restore. On the remote system, you would use MRGOBJ as: MRGOBJ FROMLIB(TFR) TOLIB(PROD1) The command does the following: Replaces any data base files. By default, any data in the corresponding To library is copied to the From library version. An option exists to use the From library data for specific files. If any source files exist in the From library that also exist in the To library, the members are copied to the corresponding file in the To library. If a From member has 0 records, the member is not copied and an error is noted. The From source file is then deleted. If a source file exists in the From library, but not in the To library, the source file is created and the members are copied. The From source file is then deleted. ** Each of the remaining objects in the From library is then check to see if a corresponding object exists in the To library. If so, the To object is deleted. The From library object is then moved to the To library. A spooled file is created with the detail information about the source and objects that have been merged into the To library. It is assumed that the user running the command is authorized to perform the deletes and moves. If not, error conditions will occur. Error handling -------------- If an error occurs while attempting to delete a logical file or process source, an escape message is sent and the command ends immediately. The spooled file will contain the object or member that has caused the problem and the job log may need to be examined. After correcting the problem, the MRGOBJ command should be run again. If an error occurs during the deletion and moving of objects, the command will in most cases continue and report the error when the command completes. Manual correction would normally be used. Command parameters CMD ------------------ FROMLIB The library containing the objects to be merged into the To library. For data base data files, the physical and logical files are moved to the new library. Existing files are deleted. By default, the data in the physical files to be replaced is copied to the From file first. See also the FRMFILDATA parameter. For source files, the members are copied individually rather than replacing the entire object. This allows a subset of the members to be replaced. For all other objects, any corresponding To object will be deleted and the new object moved to the To library. TOLIB The library where the objects should be moved to. FRMFILDATA A list of up to 40 files in the From Library where the data in the From Library should be used instead of any existing data in the To Library file. If the corresponding file does not exist in the To Library, the file need not be described. Restrictions ------------ The user of the object must be authorized to the the objects and libraries so that delete and move operations may be performed. Prerequisites ------------- The following TAA Tools must be on your system: DLTOBJ2 Delete object 2 EXTLST Extract list RTVDBFA Retrieve data base file attributes RTVSYSVAL3 Retrieve system value 3 SNDCOMPMSG Send completion message SNDDIAGMSG Send diagnostic message SNDESCMSG Send escape message SNDSTSMSG Send status message Implementation -------------- None, the tool is ready to use. Objects used by the tool ------------------------ Object Type Attribute Src member Src file ------ ---- --------- ---------- ---------- MRGOBJ CMD TAALIBU QATTCMD TAALIBUC PGM CLP TAALIBUC QATTCL TAALIBUC2 PGM CLP TAALIBUC2 QATTCL TAALIBUC3 PGM CLP TAALIBUC3 QATTCL TAALIBUC4 PGM CLP TAALIBUC4 QATTCL TAALIBUC4 PGM CLP TAALIBUC5 QATTCL TAALIBUR PGM RPG TAALIBUR QATTRPG

MRGOBJ          MERGE OBJECTS                          TAALIBU


The Merge  Objects command  is intended  for the case  where you  batch
the changes  that are to go  into production.  The  command handles the
merging  in of normal objects, data  base networks, and source members.
Either new  or  replacement objects/members  are  handled.   An  option
exists to  retain or replace the  production data.  The  command can be
used on the same system or a remote system.

The  RPLDUPOBJ  tool provides  a  command  that may  be  considered for
simple use.

The MRGOBJ  command is  intended to  work with  the  DUPCHGOBJ tool  or
your  own function  to  place the  new object  versions  in a  separate
library  before merging them  into production.   The concept  of MRGOBJ
can be used in maintaining an application:

  **   On  the  same  system  (for  example,  you  have  a  development
       library)

  **   On another system or systems in the same machine room.

  **   On remote systems.

For  example, assume  you have  a  standard application  that  is on  a
development  system and  remote systems.   Changes need  to be  made in
certain  objects.    After  testing  the  changes  on  the  development
system,  you would  first  use  the  DUPCHGOBJ tool  to  duplicate  the
changed objects  from the production library on  the development system
to a 'transfer' library.

            DUPCHGOBJ    FROMLIB(PROD1) TOLIB(TFR)

You  would  then  transfer  the library  to  the  remote  system either
electronically or using save/restore.

On the remote system, you would use MRGOBJ as:

             MRGOBJ      FROMLIB(TFR) TOLIB(PROD1)

The command does the following:

  **   Replaces any  data base  files.   By default,  any  data in  the
       corresponding  To  library   is  copied  to  the   From  library
       version.   An  option exists to  use the  From library  data for
       specific files.

  **   If any source files  exist in the From  library that also  exist
       in the To library,  the members are copied to  the corresponding
       file in  the To library.   If a  From member has  0 records, the
       member  is not copied  and an error  is noted.   The From source
       file is then deleted.

  **   If a source file exists in  the From library, but not in  the To
       library,  the  source  file  is  created  and  the  members  are
       copied.  The From source file is then deleted.

  **   Each  of  the remaining  objects  in  the From  library  is then
       check  to see  if  a  corresponding  object  exists  in  the  To
       library.   If so, the  To object is  deleted.  The  From library
       object is then moved to the To library.

A  spooled  file  is created  with  the  detail  information about  the
source and objects that have been merged into the To library.

It is  assumed that  the  user running  the  command is  authorized  to
perform the deletes  and moves.   If not, error conditions  will occur.

Error handling
--------------

If  an  error occurs  while  attempting  to delete  a  logical file  or
process  source,  an  escape  message  is  sent  and  the  command ends
immediately.  The spooled  file will contain the object or  member that
has  caused the  problem  and the  job  log may  need  to be  examined.
After  correcting the problem, the MRGOBJ  command should be run again.

If an  error occurs  during the  deletion and  moving  of objects,  the
command  will in  most cases  continue and  report the  error when  the
command completes.  Manual correction would normally be used.

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

   FROMLIB       The library  containing the objects to  be merged into
                 the To library.

                 For data  base data  files, the  physical and  logical
                 files are  moved to the  new library.   Existing files
                 are  deleted.  By  default, the  data in  the physical
                 files  to  be  replaced  is copied  to  the  From file
                 first.  See also the FRMFILDATA parameter.

                 For   source   files,    the   members   are    copied
                 individually   rather   than  replacing   the   entire
                 object.   This  allows a subset  of the  members to be
                 replaced.

                 For all  other objects,  any corresponding  To  object
                 will be  deleted and  the new object  moved to  the To
                 library.

   TOLIB         The library where the objects should be moved to.

   FRMFILDATA    A  list of up  to 40 files  in the From  Library where
                 the data in  the From Library  should be used  instead
                 of any existing data  in the To Library file.   If the
                 corresponding file  does not exist in  the To Library,
                 the file need not be described.

Restrictions
------------

The  user  of the  object must  be authorized  to  the the  objects and
libraries so that delete and move operations may be performed.

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

The following TAA Tools must be on your system:

     DLTOBJ2         Delete object 2
     EXTLST          Extract list
     RTVDBFA         Retrieve data base file attributes
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDDIAGMSG      Send diagnostic message
     SNDESCMSG       Send escape message
     SNDSTSMSG       Send status message

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

None, the tool is ready to use.

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

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

   MRGOBJ        *CMD                   TAALIBU       QATTCMD
   TAALIBUC      *PGM       CLP         TAALIBUC      QATTCL
   TAALIBUC2     *PGM       CLP         TAALIBUC2     QATTCL
   TAALIBUC3     *PGM       CLP         TAALIBUC3     QATTCL
   TAALIBUC4     *PGM       CLP         TAALIBUC4     QATTCL
   TAALIBUC4     *PGM       CLP         TAALIBUC5     QATTCL
   TAALIBUR      *PGM       RPG         TAALIBUR      QATTRPG

Added to TAA Productivity tools May 1, 1996

Home Page

Up to Top