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 DLTOBJ if
the object already exists in the TOLIB library. The
TAA Tool DLTOBJ only deletes typical object types.
If an object type exists which is not processed by
DLTOBJ, 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
DLTOBJ 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
|
