TAA Tools
MOVLIBOBJ       MOVE LIBRARY OBJECTS          TAALIBE

The Move  Library  Objects command  moves some  or all  of the  objects
from  one library to  another.   This is  useful for mass  migration of
objects.

The typical command would be:

      MOVLIBOBJ    FROMLIB(xxx) TOLIB(yyy)

All  objects which can be moved would be.   Some object types like *JRN
and *JRNRCV cannot be moved.   You must also be properly  authorized to
move an object.

At  the  completion  of  the  command, a  completion  message  is  sent
describing  the number  of objects moved,  the number  bypassed and the
number where failures (e.g.   not authorized)  occurred.  If an  object
type or  generic name is  used, only  the objects meeting  the criteria
are considered.

Options exist on the command to move only:

  **   A specific object type (e.g.  *FILE).

  **   Generically named objects (An asterisk need not be specified)

  **   Objects  which start with  other than Q.   This can  be of value
       when moving user objects from QGPL.

Combinations of criteria can  be specified such as  move all the  files
beginning with ABC:

      MOVLIBOBJ    FROMLIB(xxx) TOLIB(yyy) OBJTYPE(*FILE) GENNAME(ABC)

To move all  the objects from QGPL that  do not start with Q  you would
specify:

      MOVLIBOBJ    FROMLIB(QGPL) TOLIB(yyy) EXCLUDE(*QNAMES)

An option  also exists to  delete an existing  object of the  same name
and type in the TOLIB library.

Dependent logical files
-----------------------

If  a data base  network of physical  and logical files  is being moved
to replace  an existing  network,  you must  specify DLTEXIST(*YES)  as
with  any request  to move  an object  when the  TOLIB already  has the
same object.

If  DLTEXIST(*YES) is specified and  the object type is  *ALL or *FILE,
a  separate  reading  of  the  outfile  occurs  to  first   delete  any
corresponding logical  files before  attempting to  move the data  base
network.

This  allows  the network  to  be replaced  even  if  dependent logical
files exist.

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

   FROMLIB       The library to move from.

   TOLIB         The library to move to.

   OBJTYPE       The object type to  move.  The default  is *ALL.   Any
                 object type  which can be  specified on MOVOBJ  can be
                 moved.

   GENNAME       A generic  name.  The  default is *NONE.   The generic
                 name should be entered without an *.

   EXCLUDE       Exclude  object.  The  default is *NONE.   *QNAMES can
                 be entered  to exclude  any objects  which begin  with
                 Q.

   DLTEXIST      Delete  existing object.    The default  is *NO  which
                 causes  a diagnostic message to occur  if an object of
                 the same name/type exists in the TOLIB library.

                 *YES may be specified to  use the TAA tool DLTOBJ2  if
                 the object already  exists in the TOLIB  library.  The
                 TAA  Tool DLTOBJ2  only deletes typical  object types.
                 If an object  type exists  which is  not processed  by
                 DLTOBJ2,  the  object   will  not  be  moved   and  an
                 diagnostic message will be sent.

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

None.

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

The following TAA Tools must be on your system:

      CHKGENERC     Check generic
      DLTOBJ2       Delete object
      EDTVAR        Edit variable
      SNDCOMPMSG    Send completion 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
   ------        -----      ---------      ----------     -----------

   MOVLIBOBJ     *CMD                      TAALIBE        QATTCMD
   TAALIBEC      *PGM          CLP         TAALIBEC       QATTCL
   TAALIBEC2     *PGM          CLP         TAALIBEC2      QATTCL
					

Added to TAA Productivity tools April 1, 1995


Home Page Up to Top