ZOMExec
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