MOVALLOBJ MOVE ALL OBJECTS TAAOBMS |
The Move All Objects command moves one or more objects from one
library to another. An option allows a determination of what
processing should occur if the object already exists in the To
library. The default moves only objects that do not exist in the To
library.
You must have *OBJMGT to any objects to be moved. If an object is to
be replaced, you must have all authority to the To library object so
it may be deleted before the move.
A typical command would be:
MOVALLOBJ OBJ(ABC/*ALL) TOLIB(DEF)
By default, only objects in the ABC library that do not exist in
library DEF would be moved. If a corresponding object exists in the
To library, a diagnostic message would be issued for each occurrence
and an escape message issued after all objects were processed.
MOVALLOBJ escape messages you can monitor for
---------------------------------------------
TAA9891 Some errors occurred. See previous *Diag messages
TAA9892 No objects were found for the OBJ and OBJTYPE
Escape messages from based on functions will be re-sent.
MOVALLOBJ Command parameters *CMD
----------------------------
OBJ The qualified name of the object(s) to be moved. A
specific object, a generic name, or *ALL may be
specified.
A specific library must be named.
TOLIB The library where the objects should be moved to.
OBJTYPE The object type of the objects to be moved. *ALL is
the default. Use the prompter for the specific
types that are supported.
OBJOPT The option that determines what should happen if a
corresponding object and type already exist in the
To library.
*NEW is the default, meaning only objects that are
new (do not have a corresponding object in the To
library) will be moved. If a corresponding object
exists, a diagnostic message is issued for each
occurrence and an escape message will be sent after
all objects have been processed.
*NEWRPL may be specified which will cause new
objects (no corresponding object) to be moved.
Objects that have a corresponding object in the To
library will be deleted and then the object will be
moved.
*REPLACE may be specified meaning only objects that
have a corresponding object will be moved (the
existing object is first deleted). Any objects that
do not have a corresponding object in the To library
will cause a diagnostic message and an escape
message will be issued after all objects are
processed.
*BYPASS may be specified meaning new objects are
moved. If a corresponding object exists in the To
library, a diagnostic message is sent (has leading #
symbols), but is not considered an error. If no
errors exist, the command will complete normally.
Restrictions
------------
You must have *OBJMGT authority for any objects to be moved.
You must have *ALL authority for any objects in the To library to be
deleted.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKOBJ3 Check object 3
CVTOBJD6 Convert object description 6
EDTVAR Edit variable
RSNLSTMSG Resend last message
SNDCOMPMSG Send completion message
SNDDIAGMSG Send diagnostic message
SNDESCINF Send escape information
SNDESCMSG Send escape message
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
MOVALLOBJ *CMD TAAOBMS QATTCMD
TAAOBMSC *PGM CLP TAAOBMSC QATTCL
|
Added to TAA Productivity tools October 15, 2013