613-518-1166 info@zimdatabases.com

Zim Object Manager (ZOM)

ZOMExec

< All Topics

Execute a user query against selected objects.

Syntax

ZOMExec 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.
;q The name of a query program created using the DPSMakeQuery command.

Comments

ZOMExec executes the specified query for each of the objects selected. The query must be created using the DPSMakeQuery command. Information on the current object being processed by ZOMExec is provided to the query program in a collection of pre-defined variables:

vObjectName The name of the object.
vObjectDirName The name of the Zim directory containing the object.
vObjectOwnerName The name of the owning object.
vObjectKey The object’s unique identifier key.
vObjectType The type of the object.
vObjectActive The active property; “Y” indicates active.
vObjectLocked The locked property; “Y” indicates locked; “D” indicates the Zim directory is locked.

Example

The following command executes the query “Change_Colors” for each object of type Form.

ZOMExec +t Form ;q Change_Colors

Was this article helpful?
0 out Of 5 Stars
5 Stars 0%
4 Stars 0%
3 Stars 0%
2 Stars 0%
1 Stars 0%
How can we improve this article?
Table of Contents