ZOMEnable

Enables the ZOM services for use in a Zim session.

Syntax

ZOMEnable

Comments

You must enable ZOM before using any of the ZOM services.

Since ZOM is always enabled, the Object Dictionary facilities in the Development Center use the ZOM services to manage your objects.

Example

The following command enables ZOM.

ZOMEnable

ZOMMake

Rebuilds an application database.

Syntax

ZOMMake

Comments

ZOMMake is the equivalent of executing ZOMRecreate, ZOMTouch, and ZOMCompile in sequence. However ZOMMake has the intelligence to only recreate objects and compile programs that have changed. Not only does ZOMMake recompile programs that have modified dependent objects, but it also recompiles programs where the source code has been modified.

ZOMReset

Rebuilds the ZOM knowledge base.

Syntax

ZOMReset

Comments

ZOMReset command is used as a ‘last resort’ solution to system level problems such as corrupt indexes on the object key for object definitions.

ZOMReset completes the following tasks:

  • Erases the index on the object key for object definitions.
  • Deletes all object keys for object definitions.
  • Recreates the index on the object key for object definitions.
  • Executes the ZOMFixup command.

ZOMDisable

Disables the ZOM services for use in a Zim session.

Syntax

ZOMDisable

Comments

You must enable ZOM before using any of the ZOM services in a Zim session. If you no longer wish to use ZOM, ZOM services can be turned off using ZOMDisable.

With ZOM enabled, the Object Dictionary facilities in the Development Center use the ZOM services to manage your objects. When ZOM is disabled, the Development Center uses basic Zim object management facilities.

Example

The following command disables ZOM.

ZOMDisable

ZOMFixUp

Analyses the information maintained by ZOM and corrects any problems.

Syntax

ZOMFixUp

Comments

This command analyses the information maintained by ZOM and makes any necessary corrections. For example, it makes sure that the object keys and names stored within ZOM are consistent with the information in the Object Dictionary. These sorts of inconsistencies can arise as a result of certain special kinds of manual Object Dictionary updates made outside ZOM. ZOMFixUp does not look at the consistency of object dependency information. Use the ZOMTouch command to update dependency information.

ZOMFixUp also resets any temporary EntitySets (the Shadow Dictionary, for example) used by ZOM to their initial state. These EntitySets can get quite large and, since they contain only temporary data, restoring them to their initial size can save a considerable amount of disk space.

Example

The following command ensures that the information maintained by ZOM is correct and consistent and restores all temporary EntitySets used by ZOM to their initial size.

ZOMFixUp

ZOMUnCompile

Uncompiles selected documents.

Syntax

ZOMUnCompile object specification [option...]

Options

;k [!]The ;k option is used to assign 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 object(s).
;p [!]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

The specified objects are uncompiled.This command touches the objects as uncompiled 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.

Example

The following command uncompiles the compiled objects that do not have the Compilable property set.

ZOMUnCompile +p ca -p c

ZOMCopy

Copy selected objects.

Syntax

ZOMCopy object specification [option...] target object [;t dir]

Options

;k [!]The ;k option is used to assign 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 object(s).
;p [!]Set the specified user-designated property for the selected object(s). If “!” is indicated, the specified property is reset for the selected object(s).
;t dirSpecifies that is an existing directory.

Comments

ZOMCOPY makes a new object called by copying an existing object. If the is identified as a directory by using “;t dir”, ZOMCOPY copies all objects specified by the object list specification to the specified directory.This command touches the objects copied once its action has completed. This results in the object’s status and dependency information being updated. For more information, refer to ZOMTouch.

Examples

The following command makes a copy of the object “Customers” and names the new copy “TmpCusts.”

ZOMCopy Customers > TmpCusts

The following copies all objects whose names begin with “Cust” to the directory “CustDir”.

ZOMCopy Cust* > CustDir ;t dir

ZOMCompile

Compiles selected documents.

Syntax

ZOMCompile object specification [option...]

Options

;k [!]The ;k option is used to assign 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 object(s).
;p [!]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

This compiles all objects specified by the object list specification.This command touches the objects compiled 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 compiles the program “pMainMenu”:

ZOMCompile pMainMenu

The following command compiles all programs that have a compile status indicating that they need compilation:

ZOMCompile +p cn

The following command compiles all programs that depend on the object “Customers”. This is used immediately following a recreate of the object “Customers”.

ZOMCompile Customers +x

ZOMReCreate

Recreates selected objects.

Syntax

ZOMReCreate object [Options]

Options

;k [!]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 [!]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

The specified objects are recreated.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 recreated 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 recreated 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 the Object Dependencies section.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 recreates the object “Customers.”

ZOMReCreate Customers

The following command recreates all objects which are considered to be out-of-date.

ZOMReCreate +p ec

 

pt_BRPortuguese