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.
;a
If 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.
;b
If 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.
;w
If 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.”
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.
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.”
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.
;a
If 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.
;b
If 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.
;w
If 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.
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.”
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
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.
Generates a program to import dictionary information of selected objects into the Object Dictionary.
Syntax
ZOMDDBoot 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.
;a
If 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.
;b
If 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.
;w
If 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 statements which construct the Object Dictionary description for the objects indicated. It is used to generate system bootstrap scripts. It is not as efficient as using ZOMExport ZOMImport
Examples
The following command generates a program which, when executed, populates the Object Dictionary with the description of the object “Customers.” The output is written to the screen.
ZOMDDBoot Customers
The following command writes the same program out to the document BuildCusts.
Generates a program to create all selected objects.
Syntax
ZOMCrtBoot 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.
;a
If 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.
;b
If 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.
;w
If 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 command generates a program consisting of create statements for the selected objects. It is used to generate system bootstrap scripts. The scripts generated preserves the file numbers of directories, entity sets, and relationships with fields. As well, code is generated to make a copy of the object’s file immediately after it is created.If a given set of objects has a complex dependency hierarchy, it can be very difficult to determine the correct order in which to create the objects. If all the objects are properly created and Dependency Tracking is enabled, this command generates the create statements in the correct order.
Examples
The following command generates a program which, when executed, creates the object “Customers.” The output is written to the screen.
ZOMCrtBoot Customers
The following command appends the same program out to the document BuildCusts.
Deletes the Object Dictionary information for selected objects (but does not erase the object or object description).
Syntax
ZOMDelete 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
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.”
Erases selected objects and deletes their dictionary and object descriptions.
Syntax
ZOMDestroy object specification [option..]
Options
;1 NOERASE
This option indicates that destroy is to not erase the object. This is especially useful in the case of predefined objects that are described in the Object Dictionary (e.g., ZimPROF, printer). You might want to remove the descriptions of these predefined objects but not erase the objects themselves.
Comments
The ZOMDestroy command deletes both Object Dictionary definitions and erases the created objects for the objects specified in the object list specification. All references to the object in the data dictionary are deleted. The object is not destroyed at the operating system level.
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 an 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 operation can potentially affect the status of programs and objects which depend on the destroyed objects. If ZOM is configured with its Explode Level to be 1, then this command finds the dependent objects and touches them. Refer to ZOMConfig and the discussion of dependencies in Object Dependencies.
Examples
The following command destroys the object named “Customers.” Its description in the Object Dictionary is deleted, it is erased, and its registration in ZOM is deleted.
ZOMDestroy Customers
The following command destroys the objects keyworded by the keyword “$ziminit” with the NOERASE option active. This causes the Object Dictionary information and registration to be deleted, but the objects are not erased from the environment.
English 
Portuguese