ZOMExec

Execute a user query against selected objects.

Syntax

ZOMExec <object specification> [<option>...]

Options

;k <keyword> [!]

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 <property> [!]

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 <document name>

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 <query>

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