************************************************
 IBM* DB2 UDB* XML Extender Versin 7.2 para AIX
************************************************

Bienvenido a IBM DB2 Universal Database (UDB) XML Extender para AIX.
Esta instalacin contiene el XML Extender Server, el cliente en tiempo de
ejecucin, ejemplos, el asistente de administracin XML y la documentacin
en lnea.


Contenido del README
--------------------

   * Requisitos de software
   * Informacin de XML Extender en la Web
   * Instalacin de DB2 XML Extender
   * Desarrollo de Aplicaciones de XML Extender
   * Programas de ejemplo
   * Notas importantes
   * Problemas conocidos

Requisitos de software
----------------------

   Sistema operativo   - AIX versin 4.2.1 o superior
   Base de datos       - DB2 UDB 7.2 o superior
   Java                - JDK 1.1.8 o superior

Informacin de XML Extender en la Web
-------------------------------------
Consulte el sitio Web en:
http://www.ibm.com/software/data/db2/extenders/xmlext/index.html

Puede acceder a la documentacin ms reciente en:
   http://www.ibm.com/software/data/db2/extenders/xmlext/library.html


Instalacin de DB2 XML Extender
-------------------------------

 IMPORTANTE:
  Si ha instalado DB2 XML Extender anteriormente, deber desinstalar la
  versin anterior antes de instalar la v7.2.

 1. Instale los componentes del producto en la mquina de destino.
 2. Establezca la instancia de DB2 XML Extender.
 3. Establezca el entorno de DB2 XML Extender.


 PASO1 - Instale los componentes del producto en la mquina de destino

 1. Inicie la sesin como superusuario root en la mquina de destino para
    instalar DB2 XML Extender.

 2. Inserte el CD-ROM en la unidad de CD-ROM.

 3. Monte la unidad de CD-ROM como /cdrom.

 4. Bajo /cdrom/db2xml/aix, la imagen contiene 7 archivos:
    readme.aix                  - este archivo readme
    .toc                        - archivo de la tabla de contenido que
                                  smitty mostrar
    db2xml_07_01.common         - archivo de paquete
    db2xml_07_01.client         - archivo de paquete
    db2xml_07_01.server.base    - archivo de paquete
    db2xml_07_01.admgui         - archivo de paquete

 5. Instale XML Extender utilizando el mandato smitty de AIX.

    Invoque smitty install_latest
      para Dispositivo / directorio de ENTRADA para software,
      especifique el directorio de instalacin.


      para SOFTWARE a instalar, especifique:
          db2xml_07_01.client        -  para instalar el cliente
          db2xml_07_01.server.base   -  para instalar el servidor
          db2xml_07_01.admgui        -  para instalar el asistente de
                                        administracin

      PF10 para salir de smitty.

    Esto realiza la instalacin de XML Extender en el directorio
    /usr/lpp/db2xml_07_01.



 PASO2 - Establezca la instancia de DB2 XML Extender

 1. Inicie la sesin como la instancia de DB2.

 2. Elimine cualquier instancia anterior de XML Extender ejecutando:
     /usr/lpp/db2xml_07_01/bin/xmlidrop

 3. Cree la nueva instancia de XML Extender ejecutando:
    /usr/lpp/db2xml_07_01/bin/xmlicrt


 PASO3 - Establezca el entorno de XML Extender

 1. Ejecute $HOME/sqllib/db2profile o finalice la sesin y vuelva a
    iniciarla.

 2. Vincule la base de datos utilizando los mandatos siguientes. Asegrese
    de haber creado la base de datos en primer lugar.


    db2 connect to <nombre de la base de datos>
    cd $HOME/dxx/bnd
    db2 bind @dxxbind.lst
    cd $HOME/sqllib/bnd
    db2 bind @db2cli.lst
    db2 terminate


Desarrollo de aplicaciones de XML Extender
------------------------------------------

 - Bajo el directorio de instalacin /usr/lpp/db2xml_07_01/samples, se
   proporcionan ejemplos para mostrar cmo ejecutar XML Extender en los
   siguientes subdirectorios:

   c     - cdigo de ejemplo para llamar a procedimientos almacenados de
           XML Extender en SQL incorporado

   cli   - cdigo de ejemplo para llamar a procedimientos almacenados de
           XML Extender en CLI

   clp   - ejemplos de las UDF de XML Extender en ejecucin mediante
           el procesador de lnea de mandatos de DB2


   cmd   - script de lnea de mandatos de las UDF de XML Extender en
           ejecucin y ejemplos de ejecutables que llaman a procedimientos
           almacenados de XML Extender.

   dad   - archivos DAD de ejemplo

   dtd   - archivos DTD de ejemplo

   xml   - documentos XML de ejemplo

   jdbc  - archivos JDBC de ejemplo

 - Consulte /usr/lpp/db2xml_07_01/samples/cmd/readme para obtener
   instrucciones sobre cmo ejecutar los archivos script en el directorio.


 - La mayora de ejemplos asume que el nombre de la base de datos es mydb
   y que XML Extender est instalado en /usr/lpp/db2xml_07_01. Si utiliza
   un nombre de base de datos o un directorio de instalacin distinto,
   necesitar modificarlos antes de ejecutar los ejemplos. Otros ejemplos
   requieren la base de datos creada por DB2.

Programas de ejemplo
--------------------

 - Para ejecutar los archivos de ejemplo en samples/cmd, complete los pasos
   siguientes:
 1. Cree una base de datos llamada mydb.
     db2 create db mydb

 2. Asegrese de que el sistema tiene una base de datos SAMPLE
    proporcionada por UDB.
    Ejecute el mandato db2sampl para crear la base de datos SAMPLE.

 3. Para vincular utilice dxxbind.lst y db2cli.lst para mydb y para las
    bases de datos de ejemplo. (Consulte el archivo readme para obtener
    informacin).

 4. Habilite mydb y las bases de datos de ejemplo.
     dxxadm enable_db mydb
     dxxadm enable_db sample

 - La secuencia correcta para ejecutar los archivos getstart_*.cmd:
 1. getstart_db.cmd
     Crea la base de datos y llena con datos cuatro tablas.

 2. getstart_prep.cmd
     Vincula la base de datos, los procedimientos almacenados de XML
     Extender y la CLI de DB2.

 3. getstart_insertDTD.cmd
     Inserta la DTD utilizada para validar el documento XML en la columna
     XML.

 4. getstart_createTabCol.cmd
     Crea una tabla de aplicacin que tendr una columna habilitada para
     XML.

 5. getstart_alterTabCol.cmd
     Altera la tabla de aplicacin aadiendo la columna que se habilitar
     para XML.

 6. getstart_enableCol.cmd
     Habilita la columna XML.

 7. getstart_createIndex.cmd
     Crea ndices en las tablas auxiliares para la columna XML.

 8. getstart_insertXML.cmd
     Inserta el documento XML en la columna XML.

 9. getstart_queryCol.cmd
     Ejecuta una sentencia de seleccin en la tabla de aplicacin y
     devuelve el documento XML.

 10.getstart_stp.cmd
     Ejecuta el procedimiento almacenado para componer la coleccin XML.

 11.getstart_exportXML.cmd
     Exporta el documento XML desde la base de datos para utilizarlo en una
     aplicacin.

 12.getstart_clean.cmd
     Limpia el entorno de la gua de aprendizaje.

Notas importantes
-----------------

 - La DTD estndar para la DAD de XML Extender (dad.dtd) est almacenada en
   "/usr/lpp/db2xml_07_01/dtd". Utilcela como referencia al definir la DAD.

 - Incluya los archivos de cabecera en el cdigo fuente. Se encuentran en
   /usr/lpp/db2xml_07_01/include.

 - Para obtener instrucciones sobre la utilizacin del Asistente de
   administracin de XML Extender, consulte el archivo Readme (Ingls)
   dxxadmin/readme_gui.htm del Asistente de administracin de XML Extender
   bajo el directorio donde ha instalado XML Extender. Para obtener el
   archivo readme_gui.htm en diferentes idiomas, vaya a los subdirectorios
   bajo el directorio de instalacin /usr/lpp/db2xml_07_01/nls.


Problemas conocidos
-------------------

 - Esta versin no da soporte a la creacin de ndices automticamente en
   columnas auxiliares. Necesitar aadir manualmente "crear ndice" tal como
   se muestra en el archivo /usr/lpp/db2xml_07_01/samples/cmd/xcolumn2.cmd

 - Aviso: Si la tabla auxiliar que ha definido es muy grande, cree un espacio
   de tabla y utilcelo cuando se habilite la columna.




-------------
    *  son marcas registradas de IBM Corporation.


