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 |
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 |
User-supplied class used to interpret collation URIs. |
collectionUriResolver |
Name of a class implementing |
User-supplied class used for resolving the URI supplied to the
|
compileWithTracing |
true|false |
Generates trace code in the expression tree, allowing a
|
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
|
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
|
displayByteCode |
true|false |
Causes files containing a human-readable print of the generated bytecode to
be output, to the directory identified by the |
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 |
The class used whenever Saxon creates an |
environmentVariableResolver |
Java class implementing
|
Defines the environment variable resolver for all queries and transforms
using this configuration. This affects the result of the XPath functions
|
errorListener |
A Java class that implements
|
Defines the default |
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 |
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 |
XML parser used for source documents. |
preEvaluateDoc |
true|false |
If true, allows calls on |
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 |
schemaValidation |
strict|lax|preserve|strip |
Controls whether schema validation is applied to input files. |
serializerFactory |
Java class that extends
|
Allows the serialization pipeline to be customized, for example to handle user-defined serialization parameters. |
sourceResolver |
Java class name implementing |
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 |
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 |
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 |
traceExternalFunctions |
true|false |
Provides diagnostics when external functions are dynamically loaded. |
traceListener |
Java Class implementing |
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 |
The |
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|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. |