The <global> element

The global input element of the configuration file contains properties defining global configuration options.

Attribute

Values

Effect

allowExternalFunctions

true|false

True if calls to external Java or .NET functions are allowed.

allowMultiThreading

true|false

True if saxon:threads attribute on xsl:for-each causes multi-threading under Saxon-EE; false to disable multi-threading. Default is true (but multi-threading only happens if explicitly requested using saxon:threads).

allowOldJavaUriFormat

true|false

True if reflexive calls to external Java functions are allowed to use the "liberal" syntax (for example "http://my.com/extensions/java.util.Date"). The default is to allow only the "strict" form of URI such as "java:java.util.Date".

collationUriResolver

Name of a class implementing CollationURIResolver

User-supplied class used to interpret collation URIs.

collectionUriResolver

Name of a class implementing CollectionURIResolver

User-supplied class used for resolving the URI supplied to the collection() function.

compileWithTracing

true|false

Generates trace code in the expression tree, allowing a TraceListener to be used at run-time.

debugByteCode

true|false

Causes bytecode generation to be run in debugging mode, for use when diagnosing a problem. Only to be used if requested by Saxonica support.

debugByteCodeDirectory

A directory name

Identifies the directory for output files produced when displayByteCode is set to true.

defaultCollation

A collation URI

(Requires Saxon-PE.) The collation URI to be used when no explicit collation is requested.

defaultCollection

A collection URI

The collection URI to be used when no argument is passed to the collection() function.

displayByteCode

true|false

Causes files containing a human-readable print of the generated bytecode to be output, to the directory identified by the debugByteCodeDir option.

dtdValidation

true|false

Controls whether DTD validation is applied to input files.

dtdValidationRecoverable

true|false

Controls whether DTD validation errors are recoverable or fatal.

entityResolver

Java class implementing org.xml.sax.EntityResolver

The class used whenever Saxon creates an XMLReader for parsing source documents.

environmentVariableResolver

Java class implementing net.sf.saxon.lib.EnvironmentVariableResolver

Defines the environment variable resolver for all queries and transforms using this configuration. This affects the result of the XPath functions available-environment-variables() and environment-variables()

errorListener

A Java class that implements javax.xml.transform.ErrorListener

Defines the default ErrorListener for reporting both compile-time and run-time errors.

expandAttributeDefaults

true|false

Controls whether attribute default values found in a DTD or schema are expanded or not.

generateByteCode

true|false

By default, Saxon-EE attempts to generate Java bytecode for evaluation of certain parts of a query or stylesheet. Setting this option to false disables this.

ignoreSAXSourceParser

true|false

Set to true to ignore the XMLReader supplied as a SAXSource as input to an XSLT transformation, to use one specified by the parser option instead.

lazyConstructionMode

true|false

If true, causes temporary trees to be constructed lazily.

lineNumbering

true|false

Controls whether line and column number information is maintained for input files.

optimizationLevel

integer, 0 to 10

Defines the level of code optimization to be applied.

parser

Java Class implementing XMLReader

XML parser used for source documents.

preEvaluateDoc

true|false

If true, allows calls on doc() with a literal argument to be evaluated early, at compile time.

preferJaxpParser

true|false

Relevant only on .NET, determines whether the Java Classpath parser is used in preference to the Microsoft .NET parser.

recognizeUriQueryParameters

true|false

If true, and the standard URIResolver is in use, query parameters such as val=strict will be recognized on URIs supplied to the doc() or document() functions.

schemaValidation

strict|lax|preserve|strip

Controls whether schema validation is applied to input files.

serializerFactory

Java class that extends net.sf.saxon.event.SerializerFactory

Allows the serialization pipeline to be customized, for example to handle user-defined serialization parameters.

sourceResolver

Java class name implementing net.sf.saxon.SourceResolver

Name of a user-supplied class that resolves unknown implementations of the JAXP Source class into a known implementation.

standardErrorOutputFile

A file name

Redirects output which would otherwise go to the stardard error output stream System.err, to this file.

streamability

off|standard|extended

Determines the test applied to see if constructs are streamable (if streaming is requested).

streamingFallback

true|false

If true, then constructs for which streaming is requested will be exectued in non-streaming mode if the code is not actually streamable.

stripSpace

all|none|ignorable

Controls what whitespace is removed from input documents (all inter-element whitespace, no inter-element whitespace, or all inter-element whitespace in elements having element-only content models).

styleParser

Java Class implementing XMLReader

XML parser used for stylesheets and schema documents.

suppressEvaluationExpiryWarning

true|false

Suppresses the warning issued to indicate that an evaluation license in use is due to expire.

suppressXsltNamespaceCheck

true|false

Suppresses the warning when there is no commonality between the namespaces used in stylesheet match patterns and the namespaces used in the source document.

timing

true|false

Outputs progress messages to System.err. Equivalent to the -t option on the command line.

traceExternalFunctions

true|false

Provides diagnostics when external functions are dynamically loaded.

traceListener

Java Class implementing net.sf.saxon.trace.TraceListener

User-defined class to be used for handling run-time trace output.

traceOptimizerDecisions

true|false

Causes tracing of decisions made by the optimizer.

treeModel

linkedTree|tinyTree|tinyTreeCondensed

Determines the tree model implementation used for input files: TinyTree, LinkedTree, or TinyTree(condensed).

uriResolver

Name of a JAXP URIResolver

The URIResolver to be used for deferencing URIs used in xsl:include, xsl:import, doc(), and document().

usePiDisableOutputEscaping

true|false

When sending output to a user-defined content handler, indicates whether JAXP-defined processing instructions are used to signal the start and end of text in which output escaping is disabled.

useTypedValueCache

true|false

If true, typed values of element and attribute nodes are cached in the TinyTree. Uses extra memory, may make execution faster.

validationComments

true|false

Only relevant when validationWarnings=true, indicates that validation error messages should where possible be added as comments in the document instance being validated rather than fatal errors.

validationWarnings

true|false

For result trees subjected to schema validation, indicates whether validation failures should be treated as warnings rather than fatal errors.

versionOfXml

1.0|1.1

Determines whether XML 1.0 or XML 1.1 rules are used for names. (1.0 means the rules before Edition 5.)

xInclude

true|false

Controls whether XInclude processing is applied to input files.