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

ZOMViewLog

View the activity and error log file.

Syntax

ZOMViewLog

Comments

Enables you to browse through the list of progress and error messages produced by the ZOM services you have been using.

Example

To review the results of the previous ZOM command, enter

ZOMViewLog

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

 

ZOMCat

Concatenates one or more documents together.

Syntax

ZOMCat 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).
;d This specifies that the output is to be written to the indicated document. The document must be already created. If the ;d option is omitted, it indicates that the output is to be written to the screen.
;aIf a document name is specified, the ;a option indicates that the output is to be appended to the end of the document. If the ;a option is omitted, it indicates that the output is to replace the contents of the document specified in ;d option.
;bIf a document name is specified, the ;b option indicates that you would like to browse the document file after the action is completed. The ;b option does not take effect if the ;d option was not used to specify an output document.
;wIf a document name was not specified, the ;w option sets pause on while the information is being listed to the screen. The ;w option does not take effect if output is directed to a document using the ;d option.

Comments

This concatenates the documents selected by the object list specification into the document specified in the target specification.

Examples

The first example lists the contents of the document “StatsRpt” to the screen while the second example copies the document “pTemplate” into the document “pNewProgram.”

ZOMCat StatsRpt

ZOMCat pTemplate ;d pNewProgram

pt_BRPortuguese