The <global> element
The global
input element of the configuration file contains properties defining global configuration options.
Attribute |
Applies to |
Values |
Effect |
allowExternalFunctions |
HE PE EE |
true|false |
True if calls to external Java or .NET functions are allowed. |
allowMultiThreading |
EE |
true|false |
True if saxon:threads attribute on |
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". |
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. |
collectionUriResolver |
HE PE EE |
Name of a class implementing CollectionURIResolver |
User-supplied class used for resolving 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 |
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. |
displayByteCode |
EE |
true|false |
Causes files containing a human-readable print of the generated bytecode to be
output, to the directory identified by the |
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 |
The class used whenever Saxon creates an |
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 |
Defines the default |
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 |
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. |
optimizationLevel |
HE PE EE |
integer, 0 to 10 |
Defines the level of code optimization to be applied. |
parser |
HE PE EE |
Name of a class that implements either the |
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. |
preferJaxpParser |
HE PE EE |
true|false |
Relevant only on .NET, determines whether the Java Classpath parser is used in preference to the Microsoft .NET parser. |
recognizeUriQueryParameters |
HE PE EE |
true|false |
If true, and the standard |
schemaValidation |
EE |
strict|lax|preserve|strip |
Controls whether schema validation is applied to input files. |
serializerFactory |
HE PE EE |
Name of a class that extends 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
|
stableCollectionUri |
HE PE EE |
true|false |
Indicates that collections read using the |
standardErrorOutputFile |
HE PE EE |
A file name |
Redirects output which would otherwise go to the stardard error output stream
|
streamability |
EE |
off|standard|extended |
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 |
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. |
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. |
timing |
HE PE EE |
true|false |
Outputs progress messages to |
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. |
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). |
uriResolver |
HE PE EE |
Name of a class implementing the JAXP URIResolver interface |
The |
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 |
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 for names. (1.0 means the rules before Edition 5.) |
xInclude |
HE PE EE |
true|false |
Controls whether XInclude processing is applied to input files. |