ZOMCreate

Create selected objects.

Syntax

ZOMCreate <object> [...]

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

ZOMCreate create the objects indicated. Full dependency information is not available for the objects before they are created, so ZOM assumes some basic dependencies prior to attempting the create in an attempt to get the objects in the right order. Some esoteric circumstances, like a relationship that depends on the role of another relationship do not necessarily work in one pass. What happens is that some of the objects on the list fail to create. Once the first pass at the create has completed, you can find out which objects failed to create by using the Exists property, as shown below:

ZOMList +p e!

This command lists all the objects which are currently not created. If you suspect that these objects failed to create because they were executed in the wrong order, you can ask ZOMCreate to create only the non-existent objects, as shown below:

ZOMCreate +p e!

This command touches the objects created 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 creates the object “Customers.”

ZOMCreate Customers

The following command creates all objects that have not yet been created.

ZOMCreate +p e!

ZOMReName

Renames selected objects.

Syntax

ZOMReName object specification option list

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

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

ZOMCompileBoot

Generates a program to compile all the compilable documents selected.

Syntax

ZOMCompileBoot 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 generates a program consisting of compile statements that compile the objects indicated. It is used to generate system bootstrap scripts.

Examples

The following command generates a program that, when executed, compiles the program “pEditCusts.” The output is written to the screen.

ZOMCompileBoot pEditCusts

The following command writes a program that compiles all compilable objects out to the document CompAll.

ZOMCompileBoot +p c ;d CompAll

ZOMMove

Moves selected objects to another directory.

Syntax

ZOMMove object specification [option...]

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

ZOMMove causes the specified objects to be moved into the directory specified as the target. None of the objects to be moved can have an object of the same name already in existence in the target directory. There can not be more than one object moving into the directory of the same 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 moved 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 moved 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 About 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.

Examples

The following command moves the object “Customers” into the Zim directory “SalesSys.”

ZOMMove Customers > SalesSys

The following command moves all the objects in the Zim directory “OldSales” into the Zim directory “SalesSys.”

ZOMMove OldSales.* > SalesSys

ZOMGenHelp

Generates Windows help files describing your application objects.

Syntax

ZOMGenHelp object specification [option…]

Options

;r Defines the root or main object amongst the objects for help is being generated. Help for this object becomes the first help topic that appears when you open the generated help file. It is also the “contents” help topic. Typically, the is the main program for your application.

Comments

This command places cross-referenced information about your application objects into a help file. Programs are stored as a series of help topics with object references linked to the topics for those objects. Other objects are stored as help topics that describe the attributes of each object.When you first invoke the ZOMGenHelp command, you are prompted to identify the help compiler that you want to use to create the help file. Any help compiler can be used. Press the BROWSE button to browse the folders to locate the help compiler. Once you have selected the help compiler, its name and location are saved in the Windows registry, under the following path:

HKEY_CURRENT_USERSoftwareZim Technologies International Inc.ZimHypertext

Once set, the help compiler identified in this registry value is used each time ZOMGenHelp is invoked.If you do not identify a help compiler and attempt to use ZOMGenHelp, a message is displayed, warning you that no help compiler is set, and asking if you want to locate one. Use the BROWSE function to do so.Descriptions and links are created only for those objects included in . Because of the nature of the processing required, generating help files can take quite some time.

Examples

The following command generates help files for all application objects and identifies the help for ZimPROF as the initial contents topic.

ZOMGenHelp * ;r zimprof

The resulting files can be compiled into a Windows help file by executing the following command at the operating system  prompt (assuming you have made your working directory the current directory). The HC31.exe file must be in your path when compiling from the command prompt.

HC31 APPHELP.HPJ

This command creates a help file called APPHELP.HLP.

en_CAEnglish