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

Tervetuloa IBM DB2 Universal Database (UDB) XML Extender for AIX -ohjelman
kyttjksi. Asennus sislt XML Extender Server -ohjelman, ajonaikaisen
tyasemasovelluksen, malleja, ohjatun XML-hallintatoiminnon ja kytnaikaisen
ohjeen.


README-tiedoston sislt
------------------------

   * Ohjelmistovaatimukset
   * XML Extender -tietoja Internetiss
   * DB2 XML Extender -ohjelman asennus
   * XML Extender -ohjelman sovellusten laadinta
   * Malliohjelmat
   * Trkeit huomautuksia
   * Huomioon otettavaa

Ohjelmistovaatimukset
---------------------

   Kyttjrjestelm - AIX-jrjestelmn versio 4.2.1 tai uudempi
   Tietokantaohjelma - DB2 UDB 7.2 tai uudempi
   Java-ohjelma      - JDK 1.1.8 tai uudempi

XML Extender -tietoja Internetiss
----------------------------------
Saat listietoja URL-osoitteesta
http://www.ibm.com/software/data/db2/extenders/xmlext/index.html

Uusimmat julkaisut sijaitsevat URL-osoitteessa
   http://www.ibm.com/software/data/db2/extenders/xmlext/library.html


DB2 XML Extender -ohjelman asennus
----------------------------------

 TRKE: Jos asennettuna on jokin DB2 XML Extender -ohjelman versio, se on
  poistettava ennen version 7.2 asennusta.

 1. Asenna ohjelman osat kohdekoneeseen.
 2. Luo DB2 XML Extender -ohjelman ilmentym.
 3. Mrit DB2 XML Extender -ohjelman ymprist.


VAIHE 1 - Asenna ohjelman osat kohdekoneeseen

 1. Kirjaudu kohdekoneeseen pkyttjn, jotta voit asentaa
    DB2 XML Extender -ohjelman.

 2. Aseta CD-tietolevy CD-asemaan.

 3. Ota CD-asema kyttn hakemistona /cdrom.

 4. Hakemistossa /cdrom/db2xml/aix on seuraavat 7 tiedostoa:
    readme.aix     - Readme-tiedosto
    .toc           - smitty-komennolla luotu sisllysluettelotiedosto
    db2xml_07_01.common         - tiedostopaketti
    db2xml_07_01.client         - tiedostopaketti
    db2xml_07_01.server.base    - tiedostopaketti
    db2xml_07_01.admgui         - tiedostopaketti

 5. Asenna XML Extender -ohjelma AIX-jrjestelmn smitty-komennolla.

    Anna komento: smitty install_latest
    Anna kohtaan INPUT device / directory for software asennushakemisto
    ja mrit kohtaan SOFTWARE to install

           db2xml_07_01.client -  tyasemaohjelman asennusta varten
           db2xml_07_01.server.base -  palvelinohjelman asennusta varten
           db2xml_07_01.admgui -  ohjatun hallintatoiminnon asennusta varten

    Jrjestelm asentaa XML Extender -ohjelman /usr/lpp/db2xml_07_01-hakemistoon.



 VAIHE 2 - Luo DB2 XML Extender -ohjelman ilmentym

 1. Kirjaudu sisn DB2-ilmentymn kyttjtunnuksella.

 2. Poista aikaisemmat XML Extender -ilmentymt komennolla
     /usr/lpp/db2xml_07_01/bin/xmlidrop

 3. Luo uusi XML Extender -ilmentym komennolla /usr/lpp/db2xml_07_01/bin/xmlicrt


 VAIHE 3 - Mrit XML Extender -ymprist

 1. Aja komento $HOME/sqllib/db2profile tai kirjaudu ulos jrjestelmst ja
    kirjaudu sitten uudelleen sisn.

 2. Sido tietokanta seuraavilla komennoilla (varmista ensin, ett tietokanta on
    luotuna):

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


XML Extender -ohjelman sovellusten laadinta
-------------------------------------------

 - Asennushakemiston /usr/lpp/db2xml_07_01/samples alihakemistoissa on malleja,
   jotka havainnollistavat XML Extender -ohjelman kytt. Alihakemistot ovat
   seuraavat:

   c     - mallikoodi XML Extender -ohjelman tallennettujen toimintosarjojen
           kutsumiseen esiknnettvist SQL-kskyist

   cli   - mallikoodi XML Extender -ohjelman tallennettujen toimintosarjojen
           kutsumiseen kutsutasoliittymst

   clp   - malleja XML Extender -ohjelman kyttjn mrittmien funktioiden
           ajamisesta DB2:n komentorivisuorittimessa

   cmd   - komentorivilt ajettava komentotiedosto, jolla voidaan ajaa XML
           Extender -ohjelman kyttjn mrittmi funktioita ja esimerkkej
           ajettavista ohjelmista, jotka kutsuvat XML Extender -ohjelman
           tallennettuja toimintosarjoja.

   dad   - DAD-mallitiedostoja

   dtd   - DTD-mallitiedostoja

   xml   - XML-malliasiakirjoja

   jdbc  - JDBC-mallitiedostoja

 - Tiedostossa /usr/lpp/db2xml_07_01/samples/cmd/readme on ohjeita hakemiston
   komentotiedostojen ajamiseen.

 - Useimmissa malleissa on oletettu, ett tietokannan nimi on mydb ja ett XML
   Extender -ohjelma on asennettu /usr/lpp/db2xml_07_01-hakemistoon. Jos kytt
   jotakin muuta tietokannan nime tai asennushakemistoa, malleja on muokattava
   ennen niiden ajamista. Muut mallit edellyttvt DB2:n mallitietokannan
   kytt.


Malliohjelmat
-------------


- Jotta voit ajaa samples/cmd-hakemiston mallitiedostot, tee seuraavat toimet:

  1. Luo tietokanta, jonka nimi on mydb, antamalla komento
      db2 create db mydb

  2. Varmista, ett jrjestelmss on UDB:n mukana toimitettu
     sample-mallitietokanta. Luo SAMPLE-tietokanta ajamalla komento Dv2sampl.


  3. Sido sek mydb- ett sample-tietokanta dxxbind.lst- ett db2cli.lst-
     tiedostojen avulla. (Ohjeita on Readme-tiedostossa.)

  4. Ota kyttn sek mydb- ett sample-tietokanta antamalla komennot
     dxxadm enable_db mydb
     dxxadm enable_db sample

    - getstart_*.cmd-tiedostojen ajojrjestys:
    1. getstart_db.cmd
       Luo tietokannan ja vie alkutiedot neljn taulukkoon.

    2. getstart_prep.cmd
       Sitoo tietokannan XML Extender -ohjelman tallennettuihin
       toimintosarjoihin ja DB2-kutsutasoliittymn.

    3. getstart_insertDTD.cmd
       Lis XML-asiakirjan tarkistukseen kytetyn DTD-mrityksen
       XML-sarakkeeseen.

    4. getstart_createTabCol.cmd
       Luo sovellustaulukon sarakkeen, johon sisltyy XML-tuki.

    5. getstart_alterTabCol.cmd
       Muuttaa sovellustaulukkoa siten, ett siihen listn XML-tuen
       sisltv sarake.

    6. getstart_enableCol.cmd
       Ottaa XML-sarakkeen kyttn.

    7. getstart_createIndex.cmd
       Luo hakemistot XML-sarakkeen oheistaulukoille.

    8. getstart_insertXML.cmd
       Lis XML-asiakirjan XML-sarakkeeseen.

    9. getstart_queryCol.cmd
       Ajaa sovellustaulukolle SELECT-kskyn ja palauttaa XML-asiakirjan.

   10. getstart_stp.cmd
       Ajaa tallennetun toimintosarjan, jolla muodostetaan XML-kokoelma.

   11. getstart_exportXML.cmd
       Vie XML-asiakirjan tietokannasta, jotta asiakirjaa voidaan
       kytt sovelluksessa.

   12. getstart_clean.cmd
       Puhdistaa opetusohjelman ympristn.

Trkeit huomautuksia
---------------------

 - XML Extender -ohjelman DAD-tiedoston DTD-mritystiedosto (dad.dtd) sijaitsee
   /usr/lpp/db2xml_07_01/dtd-hakemistossa. Kyt tiedostoa mallina, kun mritt
   omaa DAD-tiedostoasi.

 - Sisllyt header-tiedostot lhdekoodiin. Header-tiedostot sijaitsevat
   /usr/lpp/db2xml_07_01/include-hakemistossa.

 - Ohjeita XML Extender -ohjelman ohjatun hallintatoiminnon kytst on ohjelman
   ohjatun toiminnon englanninkielisess Readme-tiedostossa dxxadmin/readme.htm
   hakemistossa, johon XML Extender -ohjelma on asennettu. Muunkieliset
   readme_gui.htm-tiedostot sijaitsevat asennushakemistossa
   /usr/lpp/db2xml_07_01/nls.


Huomioon otettavaa
------------------

 - Tm versio ei tue automaattista oheistaulukoiden sarakkeiden indeksointia.
   Create index -ksky tulee list manuaalisesti. Esimerkki on tiedostossa
   /usr/lpp/db2xml_07_01/samples/cmd/xcolumn2.cmd

 Varoitus: Jos mritetty oheistaulukko on hyvin suuri, luo taulukkotila ja
           kyt saraketta tmn taulukkotilan avulla.



-------------
    *  IBM Corporationin tavaramerkkej tai rekisterityj tavaramerkkej.
