README.TXT
DataDirect XQuery(R)
Release 3.1
DataDirect Technologies
December 2007
***********************************************************************
Copyright (c) 2007 DataDirect Technologies Corp. All rights reserved.
***********************************************************************
This README file contains additional information not included in the
DataDirect XQuery documentation.
CONTENTS
Release 3.1 Features
Installation
DataDirect XQuery Notes
Using the Online Documents
DataDirect XQuery Files
Third-Party Licensing Agreements
Release 3.1 Features
DataDirect XQuery 3.1 provides the following new features:
- General usability
Improved error messages
New DataDirect XQuery Eclipse-based editor
Support for accessing zip files through fn:collection()
Custom output methods based on DataDirect XML Converters
Support for DataDirect XML Converters on file system folders
- Database support
DB2 V9.1 on z/OS
Informix Dynamic Server 10 and 11
MySQL 5.0.x
Oracle 11g
PostgreSQL 8.1 and 8.2
- XQuery and related standards
Support for "text" output method
Installation
Hard Disk Space Requirements
----------------------------
A complete installation of DataDirect XQuery, including online books
in PDF format, requires approximately 26.5 MB of hard disk space.
Note Regarding J2SE Installations
---------------------------------
Standard installations of J2SE on some platforms do not include the jar
file containing the extended encoding set that is required to support
some of the less common database code pages. To verify whether your
J2SE version provides extended code page support, check your J2SE
installation for the following file: charsets.jar must be installed in
the lib subdirectory of your J2SE installation directory.
If you do not have the required file for your J2SE version,
re-install J2SE, making sure that you install the international
version of J2SE.
Notes Regarding the Installation Process:
* After you have started the installation process, a progress
bar is displayed on the screen. If you choose to cancel the
installation at this stage, files that have already been copied to
your machine will not be removed. You must delete these files
manually from the installation directory.
* The DataDirect XQuery installer accepts multiple product keys. For
details, refer to the DATADIRECT XQUERY INSTALLATION GUIDE
(DDXQIG.PDF).
DataDirect XQuery Notes
The following are notes for Release 3.1 of DataDirect XQuery.
Performance
-----------
For ways to improve DataDirect XQuery performance, refer to the
DATADIRECT XQUERY USER'S GUIDE AND REFERENCE (DDXQUG.PDF).
If you are processing large XML files in your query through a GUI
environment, you may find it helpful to set the heap size Eclipse.
Eclipse uses 64 MB by default. You can set it to 256 MB using
the following command line:
eclipse.exe -vmargs -Xmx256m
In Stylus Studio Enterprise Suite, you can control the heap size
through the Java Virtual Machine page in Tools | Options.
NOTE: We recommend performance testing DataDirect XQuery directly
in your Java applications because it is faster than when running
DataDirect XQuery in a GUI environment.
Enabling Temporary Tables
-------------------------
Temporary tables can be used only if the database configuration and
authorization settings for the user allow temporary tables to be
created and populated. This is enabled by default in a typical
installation of Informix, Microsoft SQL Server, MySQL, Oracle,
PostgreSQL, and Sybase.
For DB2, make sure the user has the USE privilege on a previously
created USER TEMPORARY tablespace. Refer to your DB2 documentation for
details.
Using DataDirect XQuery with a Java VM Started with the -server Option
----------------------------------------------------------------------
When using DataDirect XQuery with a Java VM that was started with the
-server option, some XQuery expressions can crash the Java VM. This is
caused by a Java bug that can occur with any supported JDK version and
on different platforms. For information about workarounds for this
issue, contact Technical Support.
The Command-Line Utility on z/OS
--------------------------------
When running the command-line utility on a z/OS system, you must explicitly
set the encoding or the output will be unreadable. For example, you may have
to set the output encoding as "!encoding=Cp1047".
Using the Online Documents
You can view the Online Documents with Adobe Reader. The books are an
installable option for DataDirect XQuery.
NOTE: To download Adobe Reader from the Web, visit http://www.adobe.com.
DataDirect XQuery Files
When you extract the contents of the datadirectxquery.jar file to your
installer directory, the following files are extracted:
3rdPartySoftware.txt Third-Party License Restrictions
ddxqj.jar File used to install DataDirect XQuery
ExtensionTool.jar Tool for evaluation license extensions
Fixes.txt File that lists fixes in this release
installer.properties Support file for installer
Readme.txt This file
XQueryInstaller.jar File containing the installer
When you install DataDirect XQuery, the installer copies
the following directories and files to the product installation
directory (as determined by the user), represented by INSTALL_DIR.
To INSTALL_DIR/
---------------
3rdPartySoftware.txt Third-Party License Restrictions
Fixes.txt File that lists fixes in this release
Readme.txt This file
To INSTALL_DIR/books/ddxquery:
-----------------------------
books.pdf Library file for Online Books
INDEX.PDX Index file for Adobe Acrobat full-text
search
/INDEX/*.* Directory containing additional Adobe
Acrobat index files
/ddxqig/ddxqig.pdf DataDirect XQuery Installation Guide
/ddxqug/ddxqug.pdf DataDirect XQuery User's Guide and Reference
To INSTALL_DIR/examples:
------------------------
/Connect/*.* Files for the Connect example
/CustomURIResolver/*.* Files for the CustomURIResolver example
/DataLoader/*.* Files used to create and populate the sample
database in the RDBMS
/ExternalFunctions/*.* Files for the ExternalFunctions example
/ExternalVariables/*.* Files for the ExternalVariables example
/JNDIDataSource/*.* Files for the JNDIDataSource example
/RDBMSUpdate/*.* Files for the RDBMSUpdate example
/ResultRetrieval/*.* Files for the ResultRetrieval example
/xml/*.xml XML files for the examples
/XMLQuery/*.* Files for the XMLQuery example
/XQJExecute/*.* Files for the XQJExecute example
examplesreadme.txt Information file for the examples
setenv.bat Batch file for setting CLASSPATH
setenv.sh Shell script for setting CLASSPATH
To INSTALL_DIR/help (online help folders/files):
-----------------------------------------------
*.css Stylesheets for HTML help system
help.htm Launch file for HTML help system
/installationguide/*.* HTML help system for installation guide
/reference/*.* HTML help system for reference
/wwhelp/*.* Support files for HTML help system
To INSTALL_DIR/javadoc (Javadoc folders/files):
----------------------------------------------
*.css Stylesheets for Javadoc
*.html Javadoc main files
package-list
/com/ddtek/xquery/*.* Javadoc for DataDirect XQuery proprietary
interfaces
/com/ddtek/xquery3/*.* JavaDoc for XQJ
/resources Graphic file for Javadoc
To INSTALL_DIR/lib:
-------------------
DDJDBC64Auth04.dll File required for NTLM authentication
(64-bit Itanium)
DDJDBCAuth04.dll File required for NTLM authentication
(32-bit)
DDJDBCx64Auth04.dll File required for NTLM authentication
(64-bit AMD64 and Intel EM64)
ddxq.jar DataDirect XQuery Classes
ddxqaxis.jar File containing Apache Axis classes
ddxqsaxon8.jar Redistributable third-party Saxon file
ddxqsaxon8sa.jar
JDBCDriverLogin.conf Kerberos support file
jsr173_1.0_api.jar Redistributable third-party file for StAX
compatibility
krb5.conf Kerberos support file
wstx-asl.jar File required to use the Streaming XML feature
xqbase.jar Classes required for access to all databases
xqdb2.jar Classes required for access to DB2
xqinformix.jar Classes required for access to Informix
xqmysql.jar Classes required for access to MySQL
xqoracle.jar Classes required for access to Oracle
xqsqlserver.jar Classes required for access to
Microsoft SQL Server
xqsybase.jar Classes required for access to Sybase
xqutil.jar Classes required for access to all databases
To INSTALL_DIR/planExplain:
--------------------------
/css/*.css Plan Explain resources
/imgs/*.gif Plan Explain resources
/js/*.js Plan Explain resources
/menu/css/*.css Plan Explain resources
/menu/jss/*.js Plan Explain resources
To INSTALL_DIR/src:
------------------
ddxqsaxon8.zip File containing Saxon-B sources
Third-Party Licensing Agreements
Refer to the 3rdPartySoftware.txt file in your DataDirect XQuery
installation directory for information about third-party license
restrictions.
~~~~~~~~~~~~~~~~~
End of README.TXT