Release Information:

Dependent Products:

• XDK - The Oracle XDK needs to be installed. The minimum version needed is XDK 9i production release - XDK 9.2.0.1.0
• Java JDK - The minimum JDK version that this product has been tested with is JDK 1.3
• Oracle XSU - The XML SQL utility. This is packaged with the XDK and is needed only for accessing the database through the XQuery implementation. The minimum tested version is XSU 9.2.0.1.0
• JDBC drivers - This is needed only if you access the database. The minimum JDBC drivers needed are those that work with XSU and JDK 1.3 (For Oracle, you would need the JDBC 1.3 install which includes classes12.zip)

Installation Instructions:

   Windows download

• Download xquery.zip.
• Unzip the contents into some directory e.g. C:\xquery.
• The directory will now contain the jar file (xquery.jar), a exmpl.xql, bib.xml and a doc directory.
• The doc directory contains the Java documentation for the OJXQI XQuery APIs.
• To use the XQuery implementation, set your CLASSPATH to include xquery.jar. This can be done by
• setting the environment in your local command shell to include xquery.jar
• set CLASSPATH=C:\xquery\xquery.jar;%CLASSPATH% (assuming that you unzipped to c:\xquery)
• To set the classpath globally, edit the CLASSPATH variable under the Control Panel/System/Advanced/Environment Variables and add the directory as above.

   Unix download

• Download the xquery.tar.gz file
• Unzip the contents using gunzip and untar the contents into a directory (say /private/foo/xquery)
• Set the CLASSPATH to include xquery.jar. This can be done by setting the CLASSPATH variable in your .login or .cshrc (or .shrc) files.
• If you are using a tcsh or csh, set the CLASSPATH by
• setenv CLASSPATH /private/foo/xquery/xquery.jar:${CLASSPATH} in your .login / .cshrc file
• If you are using sh (ksh or bash) set the CLASSPATH by
• CLASSPATH=/private/foo/xquery/xquery.jar:${CLASSPATH}
• export CLASSPATH

Testing the install:

• Make sure that your classpath includes the XDK jar files (xmlparserv2.jar) and the XQuery jar file (xquery.jar)
• To make sure XQLPlus is installed correctly:
• Open a command window and go to the directory in which you have unzipped the xq.zip (or xq.tar.gz).
• Run java oracle.xquery.XQLPlus exmpl.xql
• The command calls XQLPlus to run the XQuery query contained in exmpl.xql. The result must be

<bib>
    <book year="1994">
        <title>TCP/IP Illustrated</title>
     </book>
     <book year="1992">
        <title>Advanced Programming in the Unix environment</title>
     </book>
</bib>
• If you do not get the above result, please re-check your installation and make sure that your versions are correct.
• To run XQLPlus in interactive mode:
  • Open a command window and go to the directory in which you have unzipped the xq.zip (or xq.tar.gz).
  • Run java oracle.xquery.XQLPlus
  • Type in an XQuery, terminated by "/;", or type in "@empl1.xql" to run the example script
  • Type "help" for command-line settings
  • The command calls XQLPlus to run the XQuery query contained in exmpl.xql. The result must be

  XQuery Support:

  Version of the standard supported:

  The downloadable XQuery prototype is based on the November 2002 public version of the W3C XML Query document (http://www.w3.org/TR/2002/WD-xquery-20021115/). 
  
  Note: The latest public version of the W3C XML Query specification can always be found at http://www.w3.org/TR/xquery.

  Supported XQuery usecases:

  This version supports the following usecases,

  • EXMPL - all of the exemplar usecases
  • REL - most of the REL usecases 
    REL usecases not supported :
    • rel4.xql, rel17.xql - these use SOME and EVERY
    • rel8.xql, rel9.xql - these use the DATE() and YEAR() function
    • rel12.xql - user-defined functions

  See http://www.w3c.org/TR/xmlquery-use-cases for a complete list of XML Query usecases.

  Oracle extensions:

  • The document function can reference a global URL or a local filename.
  • OJXQI - is a Java API for XQuery.
  • "sqlquery" function has been added to support SQL queries inside XQuery.
  • "bind" function has been added to support bind variables.
  • XQueryX is supported.