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
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.
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.
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
Refreshes the object description of selected objects and re-computes their dependencies on other objects.
Syntax
ZOMTouch
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
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
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 dir | Specifies 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
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
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