Deletes the Object Dictionary information for selected objects (but does not erase the object or object description).

Syntax

ZOMDelete object specification [option…]

Options

Comments

ZOMDelete deletes the Object Dictionary definitions for the objects specified in the object list specification.It is important to differentiate between erasing an object, deleting an object, and destroying an object. Erasing an object undoes the act of creating an object. Creation takes a Object Dictionary description and uses it as the basis for constructing a system representation of the object in the indicated directory. Thereafter, the object can be used. Erasing an object erases this system representation, but still leaves the Object Dictionary description intact. Deleting an object deletes the object’s description from the Object Dictionary, but leaves its system representation intact. Destroying executes both an erase and a deletion, as well as deleting the registration information from the Object Dictionary. An object can be erased and deleted without being destroyed, if the ZOMErase and ZOMDelete functions are executed separately.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 deleted once its action has completed. This results in the object’s status and dependency information being updated. For more information, refer to ZOMTouch.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 deletes the object named “Customers.” Its description in the Object Dictionary is deleted, but it is not erased.

ZOMDelete Customers

The following command deletes the objects keyworded by the keyword “To_Delete.”

ZOMDelete +k To_Delete