************************************************
 IBM* DB2 UDB* XML Extender Version 7.2 for AIX
************************************************

Welcome to IBM DB2 Universal Database (UDB) XML Extender for AIX.
This installation contains the XML Extender Server, run-time client,
samples, XML administration wizard and online documentation.


README Contents
---------------

   * Software Requirements
   * XML Extender Information on the Web
   * Installing DB2 XML Extender
   * Developing XML Extender Applications
   * Sample Programs
   * Important Notes
   * Known issues

Software Requirements
---------------------

   Operating System	- AIX version 4.2.1 or higher
   Database	  	- DB2 UDB 7.2 or higher
   Java          	- JDK 1.1.8 or higher

XML Extender Information on the Web
-----------------------------------
See our Web site at:
http://www.ibm.com/software/data/db2/extenders/xmlext/index.html

The latest documentation can be accessed from:
http://www.ibm.com/software/data/db2/extenders/xmlext/library.html


DB2 XML Extender Installation
--------------------------------

 IMPORTANT:
  If you have installed DB2 XML Extender before, you must uninstall
  the previous version before installing v7.2.

 1. Install the product components on the target machine.
 2. Establish the DB2 XML Extender instance.
 3. Establish the DB2 XML Extender environment.


 STEP1 - Install the product components in the target machine

 1. Log in as the root super user on the target machine to install
    DB2 XML Extender.

 2. Insert the CD-ROM into the CD-ROM drive.

 3. Mount the CD-ROM drive as /cdrom.

 4. Under /cdrom/db2xml/aix, the image contains 7 files:
    readme.aix     - this readme file
    .toc           - table of content file picked up by smitty
    db2xml_07_01.common         - package file
    db2xml_07_01.client         - package file
    db2xml_07_01.server.base    - package file
    db2xml_07_01.admgui         - package file

 5. Install XML Extender using AIX smitty command.

    Invoke smitty install_latest
      for INPUT device / directory for software, specify the
      installation directory.

      for SOFTWARE to install, specify:
          db2xml_07_01.client 	       -  to install client
          db2xml_07_01.server.base     -  to install server
          db2xml_07_01.admgui	       -  to install admin wizard

	      PF10 to exit smitty.

    This installs the XML Extender into /usr/lpp/db2xml_07_01
    directory.



 STEP2 - Establish the DB2 XML Extender instance

 1. Log in as the DB2 instance.

 2. Remove any previous XML Extender instance by running:
     /usr/lpp/db2xml_07_01/bin/xmlidrop

 3. Create the new XML Extender instance by running:
    /usr/lpp/db2xml_07_01/bin/xmlicrt


 STEP3 - Establish the XML Extender environment

 1. Either execute $HOME/sqllib/db2profile or log off and log back in.

 2. Bind the database using the following commands. Make sure you
    have created the database first.

    db2 connect to <database name>
    cd $HOME/dxx/bnd
    db2 bind @dxxbind.lst
    cd $HOME/sqllib/bnd
    db2 bind @db2cli.lst
    db2 terminate


Developing XML Extender Applications
------------------------------------

 - Under the installation directory /usr/lpp/db2xml_07_01/samples,
   samples are provided to demonstrate how to run XML Extender
   the following directories:

   c     - sample code to call XML Extender stored procedures in
           embedded SQL

   cli   - sample code to call XML Extender stored procedures in CLI

   clp   - samples of running XML Extender UDFs through DB2 command
           line processor

   cmd   - command line script of running XML Extender UDFs and samples
           executables which call XML Extender stored procedures.

   dad   - sample DAD files

   dtd   - sample DTD files

   xml   - sample XML documents

   jdbc  - sample JDBC files

 - Check /usr/lpp/db2xml_07_01/samples/cmd/readme for instructions
   about how to run the script files in the directory.

 - Most samples assume that the database name is mydb and that
   XML Extender is installed in /usr/lpp/db2xml_07_01. If you use
   a different database name or installation directory, you need
   to modify them before you run the samples.  Other samples
   require the sample database created by DB2.

Sample Programs
---------------

 - To run the sample files in samples/cmd, complete the followings steps:
 1. Create a database named mydb.
     db2 create db mydb

 2. Make sure your system has SAMPLE database shipped by UDB.
    Run db2sampl command to create SAMPLE database.

 3. Bind using dxxbind.lst and db2cli.lst for both mydb and sample
    databases.  (See readme for instructions).

 4. Enable both mydb and sample databases.
     dxxadm enable_db mydb
     dxxadm enable_db sample

 - The correct sequence to run the getstart_*.cmd files:
 1. getstart_db.cmd
     Creates the database and populates four tables.

 2. getstart_prep.cmd
     Binds the database the XML Extender stored procedures and the DB2 CLI.

 3. getstart_insertDTD.cmd
     Inserts the DTD used to validate the XML document in the XML column.

 4. getstart_createTabCol.cmd
     Creates an application table that will have an XML-enabled column.

 5. getstart_alterTabCol.cmd
     Alters the application table by adding the column that will be
     enabled for XML.

 6. getstart_enableCol.cmd
     Enables the XML column.

 7. getstart_createIndex.cmd
     Creates indexes on the side tables for the XML column.

 8. getstart_insertXML.cmd
     Inserts the XML document into the XML column.

 9. getstart_queryCol.cmd
     Runs a select statement on the application table and returns
     the XML document.

 10.getstart_stp.cmd
     Runs the stored procedure to compose the XML collection.

 11.getstart_exportXML.cmd
     Exports the XML document from the database for use in an application.

 12.getstart_clean.cmd
     Cleans up the tutorial environment.

Important Notes
---------------

 - The standard DTD for XML Extender DAD (dad.dtd) is stored in
   "/usr/lpp/db2xml_07_01/dtd".  Use it for reference when
   defining your DAD.

 - Include the header files in your source code.  They are found in
   /usr/lpp/db2xml_07_01/include.

 - For instructions on using the XML Extender Administration Wizard,
   see the XML Extender Administration Wizard Readme (English),
   dxxadmin/readme_gui.htm under the directory where you
   installed XML Extender. For different languages of readme_gui.htm,
   look under the installation directory
   /usr/lpp/db2xml_07_01/nls.


Known issues
------------

 - This version does not support indexing on side-table columns
   automatically.  You need to manually add "create index" as
   shown in the file
      /usr/lpp/db2xml_07_01/samples/cmd/xcolumn2.cmd

 - Warning: If your defined side table is very large, create a
   tablespace and use it when the column is enabled.



-------------
    *  are trademarks or registered trademarks of IBM Corporation.


