    **************************************************************************
    **                                                                      **
    **                                                                      **
    **  (c) COPYRIGHT INTERNATIONAL BUSINESS MACHINES CORPORATION 1999.     **
    **                    TUTTI I DIRITTI RISERVATI.                              **
    **                                                                      **
    **                                                                      **
    **                                                                      **
    **************************************************************************

          Benvenuti in IBM* DB2 Universal Database* (DB2*) Extender per OS/2 Versione 6.1

    Questo CD-ROM contiene DB2 Extender*, che fornisce un ambiente run-time
    da utilizzare con le applicazioni DB2 Extender.
    Il CD-ROM comprende anche SDK (Software Developer's Kit) per la creazione
    di applicazioni DB2 Extender.


    In questo file viene descritto come installare DB2 Extender
    Versione 6.1 per OS/2. Viene, inoltre, descritto come creare e
    gestire pi instanze e come distribuire la funzione run-time. 


    REQUISITI PER L'INSTALLAZIONE
    _____________________________

    DB2 Extender comprende DB2 Image Extender, DB2 Audio Extender, DB2
    Video Extender e DB2 Text Extender. Prima di installare DB2 Extender in
    OS/2, accertarsi di poter soddisfare i requisiti di installazione per i
    relativi componenti client e server.


    REQUISITI SERVER

    I componenti server per DB2 Extender possono essere installati in un
    server OS/2.
    I componenti server richiedono l'installazione di DB2 Versione 6.1
    (o superiore) per OS/2.


    REQUISITI CLIENT

    I componenti client per DB2 Extender possono essere installati in un
    client OS/2.
    I componenti client
    richiedono l'installazione di DB2 Versione 6.1
    (o superiore) Personal Edition, DB2 Versione 6.1 (o superiore) Client
    Application Enabler o DB2 Versione 6.1 (o superiore) Software
    Developer's Kit per OS/2.


    INSTALLAZIONE DI DB2 EXTENDER IN OS/2
    _____________________________________

    Per installare i componenti client o server DB2 Extender in OS/2, si
    eseguono i passi riportati di seguito:


    1.  Inserire il CD-ROM nella relativa unit sulla stazione di lavoro
        client o server.

    2.  Aprire una finestra OS/2. Modificare l'indirizzario in: e:\db2ext\os2\it\extender

        in cui e  la lettera dell'unit CD-ROM. Se necessario, utilizzare
        una lettera di unit diversa.


    3.  Digitare INSTALL e premere INVIO. Viene visualizzata la finestra
        delle istruzioni per l'installazione di DB2 Extender.


    4.  Dopo avere letto le istruzioni di installazione nella finestra,
        fare clic sul pulsante CONTINUARE.
        Viene visualizzata la finestra Installazione e manutenzione.
        Essa elenca gli ambienti per l'installazione di DB2 Extender: server
        e client.
        Selezionare server se si sta installando DB2 Extender in un ambiente
        server OS/2 o in uno ad utente singolo OS/2.
        Selezionare client se si sta installando DB2 Extender in un
        ambiente client OS/2.

    5.  Selezionare INSTALL dal menu Azione. Viene visualizzata la finestra
        di installazione.
        Nella finestra di installazione  presente una casella di spunta:

        o   AGGIORNARE CONFIG.SYS

        Come valore assunto, la casella AGGIORNARE CONFIG.SYS  selezionata. Durante l'installazione il file CONFIG.SYS viene aggiornato
        automaticamente con le impostazioni richieste per eseguire DB2
        Extender.
        Deselezionare questa casella di spunta se si desidera memorizzare le
        modifiche richieste nel file CONFIG.ADD nell'unit di avvio senza
        aggiornare il CONFIG.SYS.  Tuttavia, non sar possibile eseguire i
        comandi di gestione DB2 Extender fino a quando le modifiche non saranno
        state aggiunte al file CONFIG.SYS.

    6.  Fare clic sul pulsante OK. Viene visualizzata la finestra Indirizzari -
        installazione.
        Questa finestra contiene un elenco di tutti i componenti disponibili
        per l'installazione.
        Per visualizzare una descrizione di un componente, selezionare
        dall'elenco SELEZIONARE I COMPONENTI CHE SI DESIDERA INSTALLARE, e
        quindi fare clic sul pulsante DESCRIZIONI.

    7.  Selezionare i componenti che si desidera installare dall'elenco.
        Quando si seleziona un componente o si fa clic sul pulsante
        SELEZIONARE TUTTO, viene visualizzato il numero di byte richiesto per
        l'installazione.


    8.  Fare clic sul pulsante SPAZIO SU DISCO per controllare che sul disco
        vi sia spazio sufficiente per installare DB2 Extender.
        Viene visualizzata la finestra Spazio su disco. Questa finestra visualizza la quantit di spazio disponibile su tutte
        le unit alle quali si ha accesso incluse quelle con accesso di sola
        lettura. Non  possibile installare DB2 Extender su unit di sola lettura.


    9.  Selezionare un'unit dall'elenco nella finestra Spazio su disco.
        In questo modo viene visualizzata la quantit di spazio disponibile e
        se  possibile installare il componente su quella unit.


    10. Dopo aver selezionato un'unit dall'elenco
        BYTE DISPONIBILI SU DISCO, fare clic sul pulsante OK per chiudere la
        finestra Spazio su disco.
        Questo specifica che DB2 Extender verr installato sull'unit
        selezionata.


    11. Come valore assunto, DB2 Extender viene installato nell'indirizzario
        C:\DMB.
        Se si desidera installare DB2 Extender in un altro indirizzario o su
        un'altra unit, sovrascrivere i seguenti campi: INDIRIZZARIO DI
        INSTALLAZIONE e FILE TEMPORANEI.


    12. Fare clic sul pulsante INSTALLARE per installare i componenti
        selezionati.


        Una volta avviato, il programma di installazione verifica che la
        stazione di lavoro soddisfi i requisiti software di DB2 Extender.
        Consultare la sezione "Requisiti di installazione" per una descrizione
        dei requisiti DB2 Extender.
        Se un requisito non viene soddisfatto, il programma visualizza un
        messaggio di spiegazione e si arresta.


        Viene visualizzata la finestra Installazione - in corso.
        Se si desidera arrestare l'installazione in un qualsiasi momento, fare
        clic sul pulsante ARRESTARE.
        Viene quindi fornita l'opzione di eliminare tutti i file gi copiati
        durante l'installazione.


        Quando l'installazione  completata, viene visualizzato un messaggio
        che informa che  necessario chiudere e riavviare la stazione di
        lavoro prima di utilizzare DB2 Extender.

    13. Fare clic sul pulsante OK nella finestra di messaggio.


    14. Fare clic sul pulsante USCIRE nella finestra DB2 Extender.

    15. Se necessario, chiudere e riavviare la stazione di lavoro.


        L'installazione di DB2 Extender  completata.
        Sar quindi presente una cartella DB2 Extender sulla scrivania
        che contiene il processore riga comandi, il programma di utilit di
        installazione e la documentazione in linea di extender (se si era scelto di
        installarla).


    INSTALLAZIONE DI DB2 EXTENDER SDK IN OS/2
    ___________________________________________


    Prima di installare DB2 Extender SDK, occorre avere installato DB2
    Extender.

    Dopo aver installato DB2 Extender, eseguire i seguenti passi:


    1.  Inserire il CD-ROM nella relativa unit sulla stazione di lavoro
        client o server.

    2.  Aprire una finestra OS/2. Modificare l'indirizzario in: e:\db2ext\os2\it\sdk

        in cui e  la lettera dell'unit CD-ROM. Se necessario, utilizzare
        una lettera di unit diversa.


    3.  Digitare INSTALL e premere INVIO. Viene visualizzata la finestra
        delle istruzioni per l'installazione di DB2 Extender SDK.

    4.  Dopo avere letto le istruzioni di installazione nella finestra,
        fare clic sul pulsante CONTINUARE.
        Viene visualizzata la finestra di installazione. Nella finestra di installazione  presente una casella di spunta:

        o   AGGIORNARE CONFIG.SYS

        Come valore assunto, la casella AGGIORNARE CONFIG.SYS  selezionata.
        Durante l'installazione il file CONFIG.SYS viene aggiornato
        automaticamente con le impostazioni richieste per sviluppare le
        applicazioni DB2 Extender.
        Deselezionare questa casella di spunta se si desidera memorizzare le
        modifiche richieste nel file CONFIG.ADD nell'unit di avvio senza
        aggiornare il CONFIG.SYS.

    5.  Fare clic sul pulsante OK. Viene visualizzata la finestra Indirizzari -
        installazione.
        Questa finestra contiene un elenco di tutti i componenti disponibili
        per l'installazione.
        Per visualizzare una descrizione di un componente, selezionare
        dall'elenco SELEZIONARE I COMPONENTI CHE SI DESIDERA INSTALLARE, e
        quindi fare clic sul pulsante DESCRIZIONI.

    6.  Selezionare i componenti che si desidera installare dall'elenco.
        Quando si seleziona un componente o si fa clic sul pulsante
        SELEZIONARE TUTTO, viene visualizzato il numero di byte richiesto per
        l'installazione.


    7.  Fare clic sul pulsante SPAZIO SU DISCO per controllare che sul disco
        vi sia spazio sufficiente per installare DB2 Extender SDK.
        Viene visualizzata la finestra Spazio su disco.
        Questa finestra visualizza la quantit di spazio disponibile su tutte
        le unit alle quali si ha accesso incluse quelle con accesso di sola
        lettura.
        Non  possibile installare DB2 Extender SDK su unit di sola lettura.

    8.  Selezionare un'unit dall'elenco nella finestra Spazio su disco.
        In questo modo viene visualizzata la quantit di spazio disponibile e
        se  possibile installare il componente su quella unit.


    9.  Dopo aver selezionato un'unit dall'elenco
        BYTE DISPONIBILI SU DISCO, fare clic sul pulsante OK per chiudere la
        finestra Spazio su disco.
        Questo specifica che DB2 Extender SDK verr installato sull'unit
        selezionata.

   10.  Come valore assunto, DB2 Extender SDK viene installato nell'indirizzario
        C:\DMB.
        Se si desidera installare DB2 Extender SDK in un altro indirizzario o su
        un'altra unit, sovrascrivere il campo: INDIRIZZARIO DI
        INSTALLAZIONE. Si raccomanda di installare DB2 Extender SDK nello
        stesso indirizzario di DB2 Extender.

   11.  Fare clic sul pulsante INSTALLARE per installare i componenti
        selezionati.


        Viene visualizzata la finestra Installazione - in corso.
        Se si desidera arrestare l'installazione in un qualsiasi momento, fare
        clic sul pulsante ARRESTARE.
        Viene quindi fornita l'opzione di eliminare tutti file gi copiati
        durante l'installazione.


        Quando l'installazione  completata, viene visualizzato un messaggio
        che informa che  necessario chiudere e riavviare la stazione di
        lavoro prima di utilizzare DB2 Extender SDK.

   12.  Fare clic sul pulsante OK nella finestra di messaggio.


   13.  Fare clic sul pulsante USCIRE nella finestra DB2 Extender SDK.

   14.  Se necessario, chiudere e riavviare la stazione di lavoro.


        L'installazione di DB2 Extender SDK  completata.


    CREAZIONE E GESTIONE DI PIU' INSTANZE
    _____________________________________

    E' possibile creare ed utilizzare pi instanze del server DB2
    Extender in un server OS/2. E' necessario creare pi instanze se sono state create pi instanze
    del server DB2 per OS/2.
    Ciascuna instanza del server DB2 Extender  associata ad una
    del server DB2 per OS/2.

    E' anche possibile elencare le instanze del server DB2 Extender
    disponibili sul sistema, eseguire pi instanze contemporaneamente ed
    eliminarle.


    CREAZIONE DI PIU' INSTANZE

    Viene creata un'instanza assunta DB2 Extender denominata DB2 durante
    l'installazione di DB2 Extender in OS/2.
    Per creare ulteriori instanze del server DB2 Extender, occorre
    essere in possesso dell'autorizzazione UPM System Administration.

    Eseguire il comando dmbicrt dal prompt di comando OS/2 come riportato
    di seguito:


      dmbicrt instanceName
              ____________

        in cui instanceName  una stringa non eccedente gli otto caratteri
    alfanumerici.
          ____________
    Il nome instanza viene utilizzato per impostare la struttura
    dell'indirizzario.


    Quando si esegue il comando dmbicrt, viene creato un sottoindirizzario
    denominato instanceName in installation_directory\INSTANCE, in
    cui installation_directory  l'indirizzario in cui  installato
    DB2 Extender.  Il valore assunto per
    installation_directory  C:\DMB.  Il sottoindirizzario contiene le
    informazioni relative agli indirizzari e alla configurazione di DB2 extender
    che sono univoche per questa instanza.
    Ad esempio, se si crea un'instanza DB2 Extender denominata dmbinst1, verr
    creato il seguente sottoindirizzario:


      installation_directory\INSTANCE\DMBINST1.
      ______________________

    Viene aggiunta una voce all'elenco delle instanze che viene conservato da
    DB2 Extender.
    Viene anche richiesta la conferma se rendere instanceName un'instanza DB2
    (nel caso in cui non lo sia gi).  Rispondere S o No.



    ELENCARE LE INSTANZE

    Eseguire il comando dmbilist per elencare tutte le instanze del
    server DB2 Extender disponibili sul sistema.

    Per determinare quale instanza  attiva, immettere il seguente comando:


      echo %DB2MMTOP%

    E' possibile anche immettere il comando set senza argomenti; tuttavia
    questo elenca tutte le variabili di ambiente.



    SELEZIONARE UN'INSTANZA

    Specificare quale instanza del server DB2 Extender utilizzare
    impostando la variabile di ambiente DB2INSTANCE sul nome di collegamento
    del proprietario dell'instanza.


    CREAZIONE DELLE INSTANZE CLIENT TEXT EXTENDER

    Se si desidera utilizzare l'API Text Extender sul client, occorre creare
    un'instanza client Text Extender.
    E' necessario creare un'instanza client Text Extender per ciascuna
    instanza DB2 che si desidera eseguire dal client.
    Per creare un'instanza client Text Extender, immettere il seguente
    comando:


          installation_directory\bin\DESICRT db2_instance_name -client
          ______________________             _________________


in cui db2_instance_name  il nome dell'instanza DB2.
          _________________
    Il comando crea i file di configurazione client Text Extender nel
    sottoindirizzario installation_directory\instance\db2_instance_name\db2tx
                     ______________________          _________________



        ESECUZIONE DI PIU' INSTANZE CONTEMPORANEAMENTE

    Per eseguire contemporaneamente pi instanze del server
    DB2 Extender, eseguire i seguenti passi per ciascuna instanza:

    o   Avviare una sessione OS/2 (cio aprire una finestra OS/2).


    o   Impostare la variabile DB2INSTANCE sul nome instanza.


    o   Avviare i servizi extender.


    ELIMINAZIONE DELLE INSTANZE

    Per eliminare un'instanza del server DB2 Extender:

    1.  Chiudere tutte le applicazioni che stanno utilizzando correntemente
        l'instanza.


    2.  Arrestare i servizi extender ed il processore riga comandi db2ext.


        Emettere i comandi dmbstop e db2ext terminate.

    3.  Eseguire, se necessario, la copia di riserva dei file
        nell'indirizzario installation_directory\INSTANCE\instanceName,
        come, ad esempio, i file qbic.

        4.  Eseguire il comando dmbidrop come riportato di seguito:

          dmbidrop instanceName
                       __________

        in cui instanceName  il nome dell'instanza DB2 Extender da cancellare.

        Il comando dmbidrop elimina la voce dell'instanza dall'elenco delle
        instanze e cancella l'indirizzario installation_directory\INSTANCE\instanceName.
        Il comando dmbidrop non elimina l'instanza DB2 associata.



        DISTRIBUZIONE DELLA FUNZIONE RUN-TIME
    _____________________________________

E' possibile copiare la funzione run-time di DB2 Extender per le
    applicazioni sviluppate nei server e nei client.
    Per copiare la funzione run-time di DB2 Extender, copiare i file del
    CD-ROM DB2 Extender che si trovano negli indirizzari
    DB2EXT\OS2\IT, DB2EXT\OS2\IT\EXTENDER e DB2EXT\OS2\COMMON\EXTENDER
    in un supporto di installazione di origine.
    Mantenere la struttura dell'indirizzario uguale a quella del CD-ROM
    DB2 Extender.
    E' possibile anche utilizzare il CD-ROM DB2 Extender come supporto di
    installazione di origine.

    La procedura di installazione dell'applicazione dovrebbe includere le
    istruzioni nella sezione precedente "Installazione di DB2 Extender in OS/2".
    Fornire le istruzioni agli installatori per modificare
    l'indirizzario nel supporto di installazione di origine nel passo 2.
    Se si sta utilizzando il CD-ROM DB2 Extender come supporto di origine,
    fornire agli installatori le istruzioni per l'immissione dell'ubicazione
    indicata al passo 2.

    E' anche possibile fornire le istruzioni agli installatori per seguire,
    facoltativamente, i passi della sezione "Creazione di pi instanze" per
    creare pi instanze.
    Gli installatori devono copiare i file per la documentazione stampabile
    dall'indirizzario seguente:


       doc/language/ps
           ________

    in cui language  un'abbreviazione a due caratteri per la lingua
           ________
    (ad esempio en per English).  Per informazioni relative alla visualizzazione ed alla stampa della
    documentazione, consultare il file docread.txt.

    
*  sono marchi della IBM Corporation.
    ** sono marchi dei rispettivi proprietari.
