ZOMReName

Renames selected objects.

Syntax

ZOMReName <object specification> <option list> > <target name>

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

ZOMReName causes the name of the objects indicated to be changed to the target object name. If more than one object is to be renamed, they are all renamed to the same name. This can occur only if objects, each in different directories, are all to be renamed at once.

ZOMReName executes a RENAME operation, and updates the Object Dictionary with the new 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 renamed 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 renamed 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 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.

Example

The following command renames the object "Customers", to "Custs."

ZOMReName Customers > Custs