ZOMMove

Moves selected objects to another directory.

Syntax

ZOMMove <object specification> [<option>...] > <target dir>

Options

;k <keyword> [!]

Assigns a keyword to the selected object(s). If the keyword is already assigned, this assignment is ignored. If "!" is specified, the keyword assignment is removed for the selected object(s).

;p <property> [!]

Set the specified user-designated property for the selected object(s). If "!" is indicated, the specified property is reset for the selected object(s).

Comments

ZOMMove causes the specified objects to be moved into the directory specified as the target. None of the objects to be moved can have an object of the same name already in existence in the target directory. There can not be more than one object moving into the directory of the same name.

This command checks the set of objects to be processed for locked objects prior to executing. If there are locked objects to be processed, the command issues an error and exits. An object is considered to be locked if it is locked itself, or is in a locked directory. For information about setting and clearing locks, refer to ZOMSet.

This command touches the objects moved once its action has completed. This results in the object's status and dependency information being updated. This operation can potentially affect the status of programs and objects that depend on the moved objects. If ZOM is configured with its Explode Level to be 1, then this command also finds the dependent objects and touches them. For more information, refer to ZOMTouch and the discussion of dependencies in About Object Dependencies.

This action results in the objects affected being keyworded as "changed." The exact keyword used is determined by ZOM's configuration. For more information, refer to ZOMConfig.

Examples

The following command moves the object "Customers" into the Zim directory "SalesSys."

ZOMMove Customers > SalesSys

The following command moves all the objects in the Zim directory "OldSales" into the Zim directory "SalesSys."

ZOMMove OldSales.* > SalesSys