*********************************************
 IBM* DB2 UDB* Extension XML pour AIX*
                Version 7.2
*********************************************

Bienvenue dans IBM DB2 Universal Database (UDB) Extension XML pour AIX.
Ce programme permet d'installer le serveur de l'Extension XML, le client
d'exploitation, les exemples, l'assistant d'administration XML et
la documentation en ligne.


Table des matires
------------------

   * Logiciels requis
   * Informations relatives  DB2 Extension XML sur le Web
   * Installation de DB2 Extension XML
   * Dveloppement d'applications Extension XML
   * Programmes exemples
   * Remarques importantes
   * Divers

Logiciels requis
----------------

   Systme d'exploitation	- AIX version 4.2.1 ou suivante
   Base de donnes	  	- DB2 UDB 7.2 ou suivante
   Java          		- JDK 1.1.8 ou suivante

Informations relatives  DB2 Extension XML sur le Web
-----------------------------------------------------
Allez sur notre site Web site  l'adresse suivante :
   http://www.ibm.com/software/data/db2/extenders/xmlext/index.html

La documentation la plus rcente est disponible sur :
   http://www.ibm.com/software/data/db2/extenders/xmlext/library.html


Installation de DB2 Extension XML
---------------------------------


    IMPORTANT :
    Si une version antrieure de DB2 Extension XML est dj
    installe sur le poste, vous devez la dsinstaller avant d'installer
    la version 7.2.

 1. Installez les composants du produit sur le poste cible.
 2. Dfinissez l'instance DB2 Extension XML.
 3. Dfinissez l'environnement DB2 Extension XML.



 ETAPE 1 - Installation des composants du produit sur le poste cible

 1. Ouvrez une session sur le poste cible en tant que super-utilisateur
     root pour installer DB2 Extension XML.

 2. Insrez le CD-ROM dans le lecteur de CD-ROM.

 3. Montez l'unit de CD-ROM en tant que /cdrom.

 4. Sous /cdrom/db2xml/aix, l'image contient 7 fichiers :
    readme.aix     - le prsent fichier readme
    .toc           - fichier de table des matires extrait par smitty
    db2xml_07_01.common         - file progiciel
    db2xml_07_01.client         - file progiciel
    db2xml_07_01.server.base    - file progiciel
    db2xml_07_01.admgui         - file progiciel

 5. Installez l'Extension XML  l'aide de la commande AIX smitty.

    Lancez smitty install_latest
    Pour le matriel/les rpertoires EN ENTREE, indiquez le rpertoire
    d'installation.


      Pour la partie LOGICIELLE  installer, indiquez :

                           db2xml_07_01.client          -  pour installer le client
                           db2xml_07_01.server.base     -  pour installer le serveur
                           db2xml_07_01.admgui          -  pour installer l'assistant                                                            d'administration

	       PF10 pour quitter smitty.

    Cette opration installe l'Extension XML dans le rpertoire
    /usr/lpp/db2xml_07_01.



 ETAPE 2 - Dfinition de l'instance DB2 Extension XML

 1. Ouvrez une session en tant qu'instance DB2.

 2. Supprimez toute instance prcdente de l'Extension XML en excutant :
     /usr/lpp/db2xml_07_01/bin/xmlidrop

 3. Crez la nouvelle instance de l'Extension XML en excutant :
     /usr/lpp/db2xml_07_01/bin/xmlicrt


 ETAPE 3 - Dfinissez l'environnement DB2 Extension XML

 1. Lancez $HOME/sqllib/db2profile, ou dconnectez-vous puis reconnectez-vous.

 2. Dfinissez les accs  la base de donnes  l'aide des commandes suivantes :
    Vrifiez que vous avez bien cr pralablement la base de donnes.

    db2 connect to <nom-bdd>
      cd $HOME/dxx/bnd
      db2 bind @dxxbind.lst
      cd $HOME/sqllib/bnd
      db2 bind @db2cli.lst
      db2 terminate


Dveloppement des applications DB2 Extension XML
------------------------------------------------

 - Le rpertoire d'installation /usr/lpp/db2xml_07_01/samples
   contient des exemples illustrant l'excution de l'Extension XML
   dans les rpertoires suivants :

   c     - Code exemple permettant d'appeler les procdures mmorises
           DB2 Extension XML en SQL imbriqu.

   cli   - Code exemple permettant d'appeler les procdures mmorises
           DB2 Extension XML via l'interface CLI.

   clp   - Exemples d'excution de fonctions UDF DB2 Extension XML via
           l'interprteur de commandes DB2.

   cmd   - Script d'excution de fonctions UDF DB2 Extension XML et d'exemples
           de fichiers excutables qui permettent d'appeler les procdures
           mmorises DB2 Extension XML.

   dad   - Fichiers DAD exemples.

   dtd   - Fichiers DTD exemples.

   xml   - Documents XML exemples.

   jdbc  - Fichiers JDBC exemples.

 - Pour savoir comment excuter les fichiers script dans le
   rpertoire, reportez-vous au fichier
   /usr/lpp/db2xml_07_01/samples/cmd/readme.

 - Dans la plupart des exemples, on suppose que le nom de la base de
   donnes est mydb et que l'Extension XML est installe dans
   /usr/lpp/db2xml_07_01. Si vous utilisez un nom de base de
   donnes ou de rpertoire d'installation diffrent, vous devez les
   modifier avant d'excuter les exemples.  Les autres exemples font
   intervenir la base de donnes Sample cre par DB2.

Programmes exemples
-------------------

 - Pour excuter les fichiers exemple dans samples/cmd, excutez
   pralablement les tapes suivantes :
 1. Crez une base de donne appele mydb.
     db2 create db mydb

 2. Assurez-vous que la base de donnes SAMPLE fournie avec UDB se trouve sur le
    systme.
    Lancez la commande db2sampl pour crer la base de donnes SAMPLE.

 3. Dfinissez les accs aux bases de donnes mydb et sample via
    dxxbind.lst et db2cli.lst.  (Pour cela, reportez-vous aux
    instructions du fichier Readme).

 4. Activez les bases de donnes mydb et sample.
     dxxadm enable_db mydb
      dxxadm enable_db sample

 -  Ordre d'excution obligatoire pour les fichiers getstart_*.cmd :
 1. getstart_db.cmd
     Cre la base de donnes et remplit quatre tables.

 2. getstart_prep.cmd
     Dfinit les accs de la base de donnes, des procdures mmorises DB2
     Extension XML et de DB2 CLI.

 3. getstart_insertDTD.cmd
     Insre la DTD utilise pour valider le document XML dans la colonne XML.

 4. getstart_createTabCol.cmd
     Cre une table d'application qui contiendra une colonne active pour XML.

 5. getstart_alterTabCol.cmd
     Modifie la table d'application en ajoutant la colonne qui sera active pour XML.

 6. getstart_enableCol.cmd
     Active la colonne XML.

 7. getstart_createIndex.cmd
     Cre des index sur les tables annexes pour la colonne XML.

 8. getstart_insertXML.cmd
     Insre le document XML dans la colonne XML.

 9. getstart_queryCol.cmd
     Excute une instruction SELECT sur la table d'application et renvoie le
     document XML.

 10.getstart_stp.cmd
     Excute la procdure mmorise pour composer la collection XML.

 11.getstart_exportXML.cmd
     Exporte le document XML  partir de la base de donnes pour l'utiliser dans une
     application.

 12.getstart_clean.cmd
     Nettoie l'environnement du tutoriel.

Remarques importantes
---------------------

 - Le fichier DTD standard de la DAD de l'Extension XML (dad.dtd) est stock
   dans "/usr/lpp/db2xml_07_01/dtd".  Utilisez-le comme rfrence lors de la
   dfinition de la DAD.

 - Incluez les fichiers d'en-tte dans le code source.  Ils se
   trouvent dans /usr/lpp/db2xml_07_01/include.

 - Pour plus d'informations sur l'utilisation de l'assistant
   d'administration de l'Extension XML, reportez-vous au fichier readme
   correspondant, English_g/readme.htm, qui se trouve dans le rpertoire
   d'installation de DB2 Extension XML. Pour avoir accs au fichier
   readme_gui.htm dans d'autres langues, reportez-vous au rpertoire d'installation
    /usr/lpp/db2xml_07_01/nls.


Divers
------

 - Cette version ne prend pas en charge l'indexation automatique
   des colonnes de tables annexes.  Vous devez ajouter manuellement
   "create index" comme indiqu dans le fichier
   /usr/lpp/db2xml_07_01/samples/cmd/xcolumn2.cmd.

 - Avertissement : Si la table annexe que vous avez dfinie est trs
   volumineuse, nous vous suggrons de crer votre propre espace table
   et de l'utiliser aprs activation de la colonne.



-------------
    *  Les termes suivis d'un astrisque (*) sont des marques d'IBM Corporation
       dans certains pays.


