The <global> element

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

Attribute

Applies to

Values

Effect

allowedProtocols

EE

String

Defines the protocols (for example "file" and "http") that may be used in URIs resolved by Saxon.

allowExternalFunctions

HE PE EE

true|false

True if reflexive calls to external Java functions are allowed.

allowMultiThreading

EE

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

PE EE

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".

allowSyntaxExtensions

PE EE

true|false

Enables use of (experimental and non-conformant) extensions to XPath syntax.

collationUriResolver

HE PE EE

Name of a class implementing CollationURIResolver

User-supplied class used to interpret collation URIs.

collectionFinder

HE PE EE

Name of a class implementing CollectionFinder

User-supplied class used for retrieving the ResourceCollection to resolve the URI supplied to the collection() function.

compileWithTracing

HE PE EE

true|false

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

debugByteCode

EE

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

EE

A directory name

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

defaultCollation

HE PE EE

Absolute URI (collation URI)

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

defaultCollection

HE PE EE

Absolute URI (collection URI)

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

defaultRegexEngine

HE PE EE

string ("S" for Saxon, "J" for Java, "N" for .NET)

Determines which regular expression engine should be used for evaluating regular expressions.

displayByteCode

EE

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

HE PE EE

true|false

Controls whether DTD validation is applied to input files.

dtdValidationRecoverable

HE PE EE

true|false

Controls whether DTD validation errors are recoverable or fatal.

eagerEvaluation

HE PE EE

true|false

Forces Saxon to do eager evaluation of expressions in contexts where normally it would do lazy evaluation, for example when evaluating variables and function results. This can make for easier debugging.

entityResolver

HE PE EE

Name of a class implementing org.xml.sax.EntityResolver

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

environmentVariableResolver

HE PE EE

Name of a class implementing 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-variable().

errorListener

HE PE EE

Name of a class implementing org.xml.sax.ErrorListener

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

expandAttributeDefaults

HE PE EE

true|false

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

generateByteCode

EE

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

HE PE EE

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

HE PE EE

true|false

If true, causes temporary trees to be constructed lazily.

lineNumbering

HE PE EE

true|false

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

markDefaultedAttributes

HE PE EE

true|false

Indicates that Saxon should retain the fact that attributes are derived from defaults defined in a schema or DTD where this information is available from the XML parser.

maxCompiledClasses

EE

integer

Places a limit on the number of classes for which Saxon will generate bytecode.

monitorHotSpotByteCode

EE

true|false

Enables monitoring of hot-spot byte-code generation.

optimizationLevel

HE PE EE

string of flags or 0

Defines the level of code optimization to be applied.

parser

HE PE EE

Name of a class that implements either the org.xml.sax.XMLReader or javax.xml.parsers. SAXParserFactory interface; or "#DEFAULT"

XML parser used for source documents.

preEvaluateDoc

HE PE EE

true|false

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

recognizeUriQueryParameters

HE PE EE

true|false

If true, query parameters such as validation=strict will be recognized on URIs supplied to the doc() or document() functions.

regexBacktrackingLimit

HE PE EE

integer

Sets a limit on the amount of backtracking performed during regular expression evaluation.

resourceResolver

HE PE EE

Name of a class implementing ResourceResolver

User-supplied class used to perform URI resolution. This resolver is used at Configuration level, and may be supplemented by local resolvers defined at task level, for example on an XsltCompiler, XQueryCompiler, XsltTransformer, or XQueryEvaluator.

retainNodeForDiagnostics

EE

true|false

Indicates that the location information held in the run-time expression tree should retain links to nodes in the original stylesheet tree.

schemaValidation

EE

strict|lax|preserve|strip

Controls whether schema validation is applied to input files.

serializerFactory

HE PE EE

Name of a class that implements SerializerFactory

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

sourceResolver

HE PE EE

Name of a class implementing the SourceResolver interface

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

stableCollectionUri

HE PE EE

true|false

Indicates that collections read using the fn:collection() function are to be stable, that is, repeated calls with the same collection URI return identical results.

stableUnparsedText

HE PE EE

true|false

Indicates that unparsed text files read using functions such as fn:unparsed-text(), function are to be stable, that is, repeated calls with the same URI return identical results.

standardErrorOutputFile

HE PE EE

A file name

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

streamability

EE

off|standard

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

streamingFallback

HE PE EE

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

HE PE EE

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

HE PE EE

Name of a class implementing the org.xml.sax.XMLReader interface, or "#DEFAULT".

XML parser used for stylesheets and schema documents.

suppressEvaluationExpiryWarning

PE EE

true|false

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

suppressXPathWarnings

HE PE EE

true|false

Suppresses all warnings issued by the XPath and XQuery parsers.

suppressXsltNamespaceCheck

HE PE EE

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.

thresholdForFunctionInlining

EE

integer

Defines a limit on the size of user-defined functions that will be inlined.

thresholdForHotspotByteCode

EE

integer

Defines how many times a code fragment must be executed before bytecode generation kicks in.

timing

HE PE EE

true|false

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

traceExternalFunctions

PE EE

true|false

Provides diagnostics when external functions are dynamically loaded.

traceListener

HE PE EE

Name of a class implementing TraceListener

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

traceListenerOutputFile

HE PE EE

string (file name)

Supplies a file as destination for trace listener output.

traceOptimizerDecisions

PE EE

true|false

Causes tracing of decisions made by the optimizer.

treeModel

HE PE EE

linkedTree|tinyTree| tinyTreeCondensed

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

unparsedTextURIResolver

HE PE EE

Name of a class implementing the UnparsedTextURIResolver interface

The class name of the UnparsedTextURIResolver to be used for deferencing URIs used in calls on fn:unparsed-text() and related functions.

uriResolver

HE PE EE

Name of a class implementing the JAXP javax.xml.transform.URIResolver interface

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

usePiDisableOutputEscaping

HE PE EE

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

EE

true|false

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

validationComments

EE

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

EE

true|false

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

versionOfXml

HE PE EE

1.0|1.1

Determines whether XML 1.0 or XML 1.1 rules are used.

xInclude

HE PE EE

true|false

Controls whether XInclude processing is applied to input files.

xpathVersionForXsd

EE

integer

Defines what version of the XPath language may be used in XML Schema 1.1 assertions and type alternatives.

xpathVersionForXslt

HE PE EE

integer

Defines what version of the XPath language may be used in XSLT 3.0 stylesheets.

zipUriPattern

EE

string

A regular expression used to decide whether a collection URI is to be treated as representing a ZIP file. The default pattern is "^jar:|\.jar$|\.zip$\.docx$\.xlsx$" which matches a URI that starts with "jar:" or that ends with ".jar", ".zip", ".docx", or ".xlsx".