Processor Settings (XQuery)


		XQuery support is available only in Stylus Studio XML Enterprise Suite and Stylus Studio XML Professional Suite.

You use the Processor Settings page of the Options dialog box to specify default settings for XQuery processors, and to specify which processor you want to use as the default processor in your XQuery scenarios. You can always select a different processor and override individual settings on the Processor tab of the Scenario Properties dialog box.

The default XQuery processor is Stylus Studio's built-in processor. If you are using DataDirect XQuery®, the default processor is the DataDirect XQuery® processor.

Fields

Processor

Drop-down list that displays available processors for XQuery. The debugging symbol changes based on whether or not the processor you have selected supports back-mapping and debugging. The following table summarizes the available processors and whether or not they support back-mapping and debugging.

Table 197. Available XQuery Processors
Processor	Supports Back-mapping and Debugging	Requires Specifying Server Settings
Built-in	Yes	No
DataDirect XQuery®	No	No
Saxon	Yes	No
TigerLogic XDMS	No	Yes*
External (external instance of the Stylus Studio built-in processor)	No	Yes*
Custom	No	No

*If you specify an external processor, you use the Server Settings button to specify the port number on which you want Stylus Studio to listen for messages coming from the processor.

Use Stylus Studio URI Resolver

Whether or not you want to enable the Stylus Studio URI Resolver, which allows the processor to resolve URIs associated with file systems peculiar to Stylus Studio (like the file system for XML conversions, for example). This setting is applicable only to Java-based processors.

Use a default processor

Whether or not you want use the processor you are configuring as the default processor for all XQuery scenarios. You can always override the default processor and individual processor settings on the Processor tab of the Scenario Properties dialog box when you create the scenario.

Custom Processor Settings

Command line, path, and classpath settings for a custom XQuery processor. These fields are active only if you select Custom in the Processor drop-down list box.

Command line

The command line used to execute the custom XQuery processor. The command line must show where to use the three arguments: %1 is the XML source file, %2 is the XQuery, %3 is the result document. For example: myparser -style %2 -source %1 -out %3, or myparser %1 %2 %3.

Path

Specifies any path information that is required to run your custom processor and that is not already defined in your PATH environment variable.

Classpath

Specifies any directories that your processor must access and that are not already defined in your CLASSPATH environment variable.