README.htm
DataDirect XQuery(R)
Release 4.0
DataDirect Technologies
December 2008
***********************************************************************
Copyright (c) 2008 DataDirect Technologies Corp. All rights reserved.
***********************************************************************
This README file contains additional information not included in the
DataDirect XQuery documentation.
CONTENTS
Release 4.0 Features
Installation
DataDirect XQuery Notes
Using the Online Documents
DataDirect XQuery Files
Third-Party Licensing Agreements
--------------------
Release 4.0 Features
--------------------
DataDirect XQuery 4.0 provides the following new features:
- Support for the XQuery Update Facility (XUF), including
- The ability to update data sources
- The ability to transform update results
- The ability to use an update result with the fn:put() function
- A new option, ddtek:automatic-update to enable automatic updates
of doc() and collection() data sources
- Support for creating and updating OOXML and ODF documents, allowing you to
both create new ZIP files and create new files withing existing ZIP files
- Numerous enhancements to the Streaming XML feature, including support for:
- Handling header information
- Aggregation functions
- Positional predicates
- The XQueryWebService framework, which allows you to expose an XQuery as
a Web service, is now included with the DataDirect XQuery installation
- A new function, ddtek:isValid(), allows you to validate an XML node returned
from an XQuery against an XML Schema
- Support for DB2 9.5
------------
Installation
------------
Hard Disk Space Requirements
----------------------------
A complete installation of DataDirect XQuery, including online books
in PDF format, requires approximately 37 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 4.0 of DataDirect XQuery.
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
/UpdateFacility/*.* Files for XUF support examples
/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:
-------------------
ddxq.jar DataDirect XQuery Classes
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)
ddxqaxis.jar Files for Web services support for ddtek:wscall()
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
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
xquerywebservice.jar Classes required to support the XQueryWebService framework
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
xquerywebservice_src.zip File containing sources for the XQueryWebService framework
--------------------------------
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.htm