RunMode property: CONQRSMGR class

Description

This property returns a number representing the run mode for a connected query instance. The values are:

Numeric Value Constant Value Description

1

RunMode_Window

Run the connected query in background mode with output to a separate browser window.

The connected query runs via Process Scheduler and uses a REN server for delivering the output XML to the user. The XML result file is delivered to both the REN server window and the Report Manager.

2

RunMode_Sched_Web

Run the connected query at a scheduled time with output to web.

The connected query is scheduled to output the XML result file to the Report Manager. It can be accessed by the user via a Report Manager link.

3

RunMode_Sched_File

Run the connected query at a scheduled time with output to a file name and location specified by the user.

4

RunMode_Prev

Run the connected query immediately in preview mode with output to a separate browser window.

The connected query is executed immediately on the application server with output to a separate browser window. The output XML is not formatted internally; the only formatting that occurs is performed by the browser. Because results only exist for the browser session and are not preserved, this mode should be used during connected query creation, debugging, and tuning only.

Note: When using the preview mode, set a limit on the number of rows returned from each query.

See MaxRowsPerQuery property: CONQRSMGR class, RunMode_Prev_DefRowNumber property: CONQRS_CONST class.

5

RunMode_Sample

Run the connected query immediately with output to a file that is suitable as a BI Publisher data source.

6

RunMode_XMLFormattedString

Run the connected query immediately with output to a formatted XML string. This formatted XML string is larger than the unformatted XML of the RunMode_Prev mode.

The connected query is executed immediately on the application server with output to a formatted XML string. This string is formatted according to the XML DOM object and is suitable for displaying in a long edit box. This mode is used by the Connected Query Quick Start wizard in which XML results are previewed on the application page in a long edit box.

Note: When using the formatted XML string preview mode, set a limit on the number of rows returned from each query.

See MaxRowsPerQuery property: CONQRSMGR class, RunMode_Prev_DefRowNumber property: CONQRS_CONST class.

This property is read-only.