### IBM(R) OS/2 WARP(R) DEVELOPER KIT,
JAVA(TM) 2 TECHNOLOGY EDITION, 1.3.1
GUIDA ALL'INSTALLAZIONE E ALLA CONFIGURAZIONE

(c) Copyright IBM Corporation 1999, 2002. Tutti i diritti riservati.

Nota: Le citazioni complete sul copyright sono incluse nella sezione Informazioni particolari di questo documento.

Questa guida fornisce informazioni relative a IBM OS/2 Warp Developer Kit, Java(TM) 2 Technology Edition, Versione 1.3.1 (Developer Kit). Fornisce informazioni sulla preparazione all'installazione dei componenti del Developer Kit, sull'installazione e fornisce inoltre informazioni utili da utilizzare in seguito all'installazione.

Il Developer Kit è supportato sui seguenti prodotti OS/2(R):

- OS/2 Warp 4 con FixPak 5 o successivo per lingue SBCS (single-byte character set)
  oppure FixPak FX00505 per lingue DBCS (double-byte character set)
- OS/2 Warp Server per e-business
- Convenience Package for OS/2 Warp 4
- Convenience Package for OS/2 Warp Server for e-business
- Convenience Package 2 for OS/2 Warp 4
- Convenience Package 2 for OS/2 Warp Server for e-business
- WorkSpace On-Demand Versione 2.0, con l'ultimo FixPak

Nota: Per informazioni sui requisiti del FixPak oppure sul sito Web IBM FixPak, consultare la sezione FixPak.

Per conoscere il numero di versione e di build di IBM Developer Kit, immettere quanto segue in una riga comandi:

         java -version

### Indice

- 1.0 PRIMA DELL'INSTALLAZIONE
- 1.1 Requisiti per l'installazione
- 1.2 Estrazione dei file per l'installazione
- 1.3 Considerazioni sulla partizione del File system
- 1.4 FixPak
- 1.5 Installazione del Developer Kit come JVM predefinito

- 1.5.1 Informazioni sulla variabile di ambiente JAVA_HOME

- 1.6 Informazioni su Netscape Communicator
- 1.7 Unione di file suddivisi
- 2.0 INSTALLAZIONE DEL DEVELOPER KIT
- 2.1 Metodo di installazione della GUI

- 2.1.1 Metodo Desktop
- 2.1.2 Metodo Richiesta comandi
- 2.1.3 Componenti non selezionabili durante l'installazione
- 2.1.4 Ripristino da un'installazione non riuscita
- 2.1.5 Livello di FixPak corretto ma installazione impossibile

- 2.2 Metodo di installazione (CID) non presidiato
  - 2.2.1 Modifica del file di risposte CID
  - 2.2.1.1 Unità di installazione dei componenti
  - 2.2.2 Avvio dell'installazione non presidiata
  - 2.2.3 Installazione del CID con codice di ritorno "riuscito" e installazione non riuscita
  - 2.2.4 Livello di FixPak corretto ma installazione impossibile
- 2.3 NVDM/2 - Considerazioni sull'installazione

- 2.3.1 Comando Static nel profilo NVDM/2

- 2.4 Installazione del Developer Kit su WorkSpace On-Demand 2.0

- 2.4.1 Installazione del Developer Kit su un server WorkSpace On-Demand 2.0
- 2.4.2 Installazione del Developer Kit su un client WorkSpace On-Demand 2.0

- 2.4.2.1 Installazione non presidiata per un client WorkSpace On-Demand 2.0
- 2.4.2.2 Modifica dei file CONFIG.SYS per i client WorkSpace On-Demand 2.0
- 2.4.2.3 Modifica dei file FIT e accesso ai client WorkSpace On-Demand 2.0
- 2.4.2.4 Assegnazione della directory USER_HOME per i client WorkSpace On-Demand 2.0
- 2.4.2.5 Abilitazione dei font per i client WorkSpace On-Demand 2.0
- 2.4.2.6 Installazione del plug-in di Netscape Communicator per i client WorkSpace On-Demand 2.0
- 2.4.2.7 Installazione dei componenti aggiuntivi del Developer Kit sul client WorkSpace On-Demand 2.0
- 2.4.2.8 Esecuzione degli esempi Java da un client WorkSpace On-Demand 2.0
- 2.4.2.9 Emissione di un trust su un client WorkSpace On-Demand 2.0
- 2.4.2.10 Compilatore JIT e client WorkSpace On-Demand 2.0
- 2.4.2.11 Creazione di un'applicazione pubblica di Java plug-in control panel per client WorkSpace On-Demand 2.0

- 2.5 Metodo di installazione IPL remota

- 2.5.1 Creazione del file di risposte
- 2.5.2 Modifica del file JAVA131.RSP
- 2.5.3 Aggiornamento dei file per Feature Install
- 2.5.4 Avvio dell'installazione IPL remota
- 2.5.5 Esecuzione degli esempi Java da un client IPL remoto

- 2.5.5.1 Emissione di un trust su un client IPL remoto

- 3.0 DOPO L'INSTALLAZIONE
- 3.1 Origini aggiuntive delle informazioni
- 3.2 Installazione dei componenti aggiuntivi
- 13.3 Considerazioni su TextField e TextArea AWT
- 3.4 Modifica dei file di proprietà font non supportata
- 3.5 Problemi di tempo nelle applet Java
- 3.6 Utilizzo di OS/2 HMS (High Memory Support) per aumentare JHS (Java heap size)

- 3.6.1 Abilitazione di OS/2 HMS
- 3.6.2 Abilitazione di JHS (Java Heap Size) per utilizzare OS/2 HMS
- 3.6.3 Limitazioni durante l'utilizzo di OS/2 HMS

- 3.7 Classe BigDecimal avanzata
- 3.8 Java Plug-in
  - 3.8.1 Installazione di Java plug-in dopo l'installazione di Netscape Communicator
  - 3.8.2 Installazione di Java plug-in dopo l'installazione di IBM Web Browser per OS/2
  - 3.8.3 Java plug-in control panel
- 3.9 Disattivazione del compilatore JIT
- 3.10 Modifica del nome file
- 3.11 Configurazione del Programma di visualizzazione applet
- 3.12 Specifica delle proprietà di sistema e delle opzioni Java
- 3.13 RMI su IIOP

- 3.13.1 Compilatore IDL-to-Java

- 3.13.1.1 Limitazioni sul compilatore IDL-Java
- 3.13.1.2 Problemi noti relativi al compilatore IDL-Java

- 3.13.2 Informazioni aggiuntive
- 3.13.3 Termini RMI-IIOP

- 3.14 JAAS (Java authentication e authorization service)

- 3.14.1 Differenza tra le versioni IBM e Sun di JAAS
- 3.14.2 Installazione di base

- 3.15 Informazioni sulla programmazione JNI
- 3.16 Considerazioni sulle prestazioni
- 4.0 PACCHETTI FONT AGGIUNTIVI
- 4.1 Installazione dei pacchetti font aggiuntivi

- 4.1.1 Metodo di installazione CID
- 4.1.2 Metodo tavolozza font

- 5.0 DOUBLE-BYTE CHARACTER SET (DBCS)- INFORMAZIONI
- 5.1 Testo del pannello di installazione mancante o troppo lungo nei paesi DBCS
- 5.2 Font TrueType installati sui sistemi in cinese
- 5.3 Program temporary Fix e FixPak per sistemi DBCS
- 5.4 Controllo della visualizzazione dei caratteri numerici arabi
- 5.5 Impostazioni dell'ambiente giapponese nella versione giapponese di OS/2 Warp 4
- 5.6 Font necessari per la versione giapponese di OS/2 Warp
- 5.7 Miglioramento della qualità dei font in OS/2 Warp Server per e-business
- 6.0 DISINSTALLAZIONE DEL DEVELOPER KIT
- 6.1 Metodo desktop
- 6.2 Metodo richiesta comandi OS/2
- 6.3 Disinstallazione del Developer Kit da WorkSpace On-Demand 2.0
- 6.4 Esecuzione di una disinstallazione non presidiata
- 6.5 Eliminazione del Developer Kit come JVM predefinito
- 7.0 LIMITAZIONI NOTE
- 8.0 INFORMAZIONI PARTICOLARI
- 9.0 MARCHI

## 1.0 PRIMA DELL'INSTALLAZIONE

Il Developer Kit è costituito da due pacchetti: un Runtime Environment ed un Toolkit. Il Runtime Environment include componenti quali JAAS (Java Authentication and Authorization Service), RMI-IIOP Runtime e il compilatore JIT (Just-in-Time). Il Toolkit contiene componenti quali il toolkit, l'Interactive Code Analysis Tool (ICAT) Debugger e Esempi.

Nota: Non è possibile installare il Toolkit a meno che non venga installato il Runtime Environment.

Se vengono scaricati file suddivisi, per ottenere ulteriori informazioni sull'unione dei file suddivisi in un file da installare, consultare la sezione Unione dei file suddivisi.

Prima di installare il Developer Kit, creare una copia del file CONFIG.SYS corrente. Questa operazione assicura la possibilità di ritornare all'ambiente originale nel caso si verifichino problemi durante l'installazione.

I riferimenti contenuti in questa guida sono i seguenti:

- OS/2 Warp 4 fa riferimento al sistema operativo OS/2 Warp 4 client e a WorkSpace On-Demand client (2.0 o 3.0).
- OS/2 Warp Server fa riferimento al sistema operativo OS/2 Warp Server per e-business e a WorkSpace On-Demand server (2.0 o 3.0).
- Java 1.1.x fa riferimento a Java 1.1.1 per OS/2, Java 1.1.4 per OS/2 Warp, IBM OS/2 Warp Developer Kit, Java(TM) Edition, 1.1.6, IBM OS/2 Warp Developer Kit, Java(TM) Edition, 1.1.7. e a IBM OS/2 Warp Developer Kit, Java(TM) Edition, 1.1.8
- Gli oggetti di questo prodotto vengono definiti come oggetti Java 1.3.1.
- Netscape Communicator, a meno che non sia specificato direttamente, fa riferimento al programma Netscape Communicator 4.04 e versioni successive.

### 1.1 Requisiti per l'installazione

Requisiti di spazio su disco:

Di seguito viene riportato un elenco delle dimensioni di file e dei componenti del Developer Kit dopo aver effettuato l'installazione. Prima di avviare l'installazione, verificare che si disponga di sufficiente spazio sul disco.

Componente | Dimensione
--- | ---
Runtime Environment | 25 MB
Toolkit | 35 MB
Esempi | 5 MB
Programma di debug ICAT per OS/2 Java | 13 MB
Dimensioni totali installate | 65 MB
Elenco dei componenti del Developer Kit e dimensione dei file dopo l'installazione.

Requisiti hardware:

- Di solito, una quantità minima di 32 MB di memoria RAM (random access memory) fornisce i migliori risultati durante l'esecuzione delle applicazioni del Developer Kit.
- Una quantità minima di 48 MB della memoria RAM è preferibile per l'esecuzione delle applet su browser utilizzando Java Plug-in.
- L'IBM consiglia l'utilizzo di un processore Intel(R) Pentium(R) (o simile) o superiore per tutti i sistemi OS/2.
- Il Developer Kit richiede una modalità a 256 colori (o superiore). Il Developer Kit non supporta le applet e le applicazioni Java utilizzando l'AWT (Abstract Window Toolkit) nella modalità a 16 colori.

Requisiti software:

- Feature Install 1.2.3 o versione successiva. È possibile scaricare la versione aggiornata di Feature Install da IBM Software Choice Catalog of Features. Prima di scaricare Feature Install, verificare i requisiti per l'installazione.
- Programma Netscape Communicator 4.0.4. o versione successiva.
- TCP/IP Versione 4.3 per OS/2 o successiva. È possibile scaricare il prodotto dalla pagina IBM Software Choice Catalog of Features.

### 1.2 Estrazione dei file per l'installazione

Per estrarre un file ZIP, ad estrazione automatica, attenersi alle seguente procedura:

1. Creare una sottodirectory (se non è stata ancora creata) per memorizzare il file ZIP sull'unità disco fisso.
2. Eseguire il file digitando il nome file e specificando l'opzione "-o" in una richiesta comandi nella directory in cui è stato trasferito il file.

   Ad esempio, per il Developer Kit, immettere quanto segue:

       javaintk.exe -o

   Per il Runtime Environment, immettere quanto segue:

       javainrt.exe -o

Se sono stati scaricati file suddivisi e occorre unirli in un unico file installabile, fare riferimento alla sezione Unione dei file suddivisi. Le informazioni sull'installazione del Developer Kit sono contenute nella sezione Installazione del Developer Kit.

### 1.3 Considerazioni sulla partizione del File system

Quando si effettua l'installazione del Developer Kit, è opportuno tener presente le seguenti considerazioni:

- Se si installa il Toolkit, il Runtime Environment viene selezionato automaticamente e installato sulla stessa unità del Toolkit.
- Il Toolkit e gli esempi devono essere installati su un'unità HPFS (High Performance File System) o JFS (Journaled File System).
- I componenti del programma di debug ICAT e del Runtime Environment possono essere installati su una partizione FAT (File Allocation Table).
- Se non si installa il Toolkit, il Runtime Environment può essere installato su una partizione FAT, HPFS o JFS. Per prestazioni migliori, installarlo su una partizione HPFS o su una partizione JFS, che supporta i nomi file lunghi.

Se si dispone di un disco fisso con una singola partizione FAT, è necessario che siano disponibili queste opzioni:

- Lasciare il sistema così com'è e installare solo il componente Runtime e, facoltativamente, il componente ICAT Debugger.
- Formattare la partizione FAT per HPFS o JFS e reinstallare tutto il software.
- Acquistare un programma per la suddivisione in partizioni del disco, ad esempio PartitionMagic. Con spazio sufficiente, un programma per la suddivisione in partizioni del disco riduce la dimensione della partizione corrente (unità C) e crea una nuova partizione (unità D logica), su cui è possibile eseguire la formattazione per HPFS.

Nota: In questo documento, il termine "partizione" fa riferimento a qualsiasi unità logica o fisica.

### 1.4 FixPak

Si applicano le seguenti considerazioni:

Livello FixPak del sistema richiesto per OS/2 Warp 4
SBCS | DBCS
FixPak 5 o versione successiva | FixPak FX00505
Considerazioni sul livello di FixPak.

Per utilizzare l'Euro nelle applet e nelle applicazioni Java
OS/2 Warp 4 | FixPak 6 o versione successiva
Livelli FixPak per l'utilizzo dell'Euro.

Nota: La visualizzazione e la conversione della codifica dell'Euro sono supportate sulle code page che contengono l'Euro.

Se si desidera immettere l'Euro, la versione SBCS (single-byte character set) di OS/2 è obbligatoria. La tastiera internazionale statunitense, UX103, supporta l'immissione dell'Euro mentre quella standard inglese non la supporta. In ogni caso, se non si dispone di una tastiera che supporti l'immissione dell'Euro, l'utente è in grado di visualizzarlo ma non è in grado di immetterlo.

Per informazioni su come scaricare un particolare FixPak, visitare il sito Web di IBM FixPak all'indirizzo:
http://ps.software.ibm.com/pbin-usa-ps/getobj.pl?/pdocs-usa/otherservices.html

### 1.5 Installazione del Developer Kit come JVM predefinita

L'installazione del Developer Kit come JVM (Java Virtual Machine) predefinita consente di eseguire il Developer Kit da una richiesta comandi. È possibile impostare il Developer Kit come JVM predefinita sia in modo permanente che temporaneo. Per ulteriori informazioni, consultare le seguenti sezioni.

#### Impostazione permanente del Developer Kit come JVM predefinita

Per impostare il Developer Kit come JVM predefinita in modo permanente, è possibile procedere nei seguenti due modi:

- Effettuare la selezione durante l'installazione della GUI.
- Se non è installato il Developer Kit (Versione 1.3), è possibile modificare manualmente l'istruzione PATH nel file CONFIG.SYS.

Per modificare l'istruzione PATH, aggiungere x:\JAVA131\JRE\BIN; all'istruzione PATH nel file CONFIG.SYS.

Se si desidera conservare una versione precedente di Java come JVM predefinita, non selezionare la casella di spunta durante l'installazione della GUI oppure, se il Developer Kit è stato già installato, non aggiungere la directory x:\JAVA131\JRE\BIN; all'istruzione PATH nel file CONFIG.SYS. Se si dispone già di una versione 1.1.x di Java installata come JVM predefinita, rimane come JVM predefinita.

Nota: È possibile migliorare le prestazioni eliminando i riferimenti al precedente rilascio di Java nel file CONFIG.SYS. Tuttavia, alcune note applicazioni non funzioneranno se viene installato il Developer Kit (versione 1.3.x) come JVM predefinita.

#### Uso temporaneo del Developer Kit per una sessione Java

Se il Developer Kit non è installato come JVM predefinito, ma si desidera usarlo in una sessione Java, modificare l'istruzione PATH. Ad esempio:

         SET PATH=x:\JAVA131\JRE\BIN;%PATH%

dove x è l'unità in cui è stato installato il Developer Kit.

È possibile migliorare le prestazioni modificando le istruzioni BEGINLIBPATH e CLASSPATH nel seguente modo:

         SET BEGINLIBPATH=x:\JAVA131\JRE\BIN;x:\JAVA131\JRE\DLL;%beginlibpath%
         SET CLASSPATH=

Nota: CLASSPATH è impostato su un valore nullo poiché JVM del Developer Kit di solito non richiede che CLASSPATH ricerchi file di classe di sistema; CLASSPATH è usato per file di classi applicative.

#### Uso temporaneo di Java 1.1.x JVM per una sessione Java

Se il Developer Kit 1.3.x è installato come JVM predefinita, ma si desidera utilizzare una sessione Java 1.1.x JVM, modificare l'istruzione PATH. Ad esempio:

        SET PATH=x:\JAVA11\BIN;%PATH%

dove x è l'unità in cui è stato installato il Developer Kit 1.1.x.

Se vengono eliminati i riferimenti a JAVA11 nel file CONFIG.SYS, è necessario modificare le istruzioni PATH, BEGINLIBPATH e CLASSPATH nel seguente modo:

        SET PATH=x:\JAVA11\BIN;%PATH%
        SET BEGINLIBPATH=x:\JAVA11\BIN;x:\JAVA11\DLL;%beginlibpath%
        SET CLASSPATH=x:\JAVA11\LIB\CLASSES.ZIP;x:\JAVA11\SWING\SWINGALL.JAR;\;

Nota: CLASSPATH è impostato sui file della libreria 1.1.x. Le impostazioni CLASSPATH per sistemi individuali sono diverse.

Per rendere eseguibili il Developer Kit e Java Plug-in, modificare PATH come mostrato sopra.

#### 1.5.1 Informazioni sulla variabile d'ambiente JAVA_HOME

Se è stato installato il Developer Kit (versione 1.3) come JVM predefinita e si dispone delle seguenti caratteristiche:

- Aggiunta manuale di una variabile dell'ambiente JAVA_HOME al file CONFIG.SYS per un livello precedente del Developer Kit
- File di comandi che impostano le variabili dell'ambiente JAVA_HOME

Procedere nel modo seguente:

- Eliminare o aggiornare la variabile dell'ambiente JAVA_HOME nel file CONFIG.SYS.
- Modificare i file di comando eliminando o modificando l'istruzione che imposta la variabile dell'ambiente JAVA_HOME.

### 1.6 Informazioni su Netscape Communicator

Il seguente elenco contiene le informazioni relative all'utilizzo del Developer Kit e di Netscape Communicator Versione 4.04 e successive:

- #### Esecuzione del programma Netscape Communicator durante l'installazione del Developer Kit

  Non è possibile installare il Developer Kit se è in esecuzione Netscape Communicator durante l'esecuzione del comando INSTALL. È necessario chiudere Netscape Communicator e poi eseguire il comando INSTALL.

- #### Netscape Communicator Versione 4.04 e compilatore JIT

  Per eseguire le applet utilizzando Netscape Communicator Versione 4.04, è necessario che il compilatore JIT (Just-in-Time) sia attivo. Tuttavia, se si desidera disattivare il compilatore JIT e utilizzare Netscape Communicator Versione 4.04, è necessario disporre del livello aggiornato di Netscape Communicator Versione 4.04. Per informazioni sul livello aggiornato, visitare il seguente sito Web:

  http://ps.software.ibm.com

- #### Caselle di spunta di installazione "fantasma" e Netscape Communicator Versione 4.61

  Se si dispone di Netscape Communicator Versione 4.61 e non è stato scaricato l'aggiornamento, è possibile che si verifichi la comparsa di caselle di spunta "fantasma" durante l'installazione. Sebbene queste caselle di spunta "fantasma" non influenzino l'installazione del Developer Kit, è possibile scaricare l'aggiornamento dal seguente sito Web:
  http://ps.software.ibm.com

- Se viene installato Java 1.3 Developer Kit e quindi vengono rimosse le voci JAVA11 dal file CONFIG.SYS o viene rimossa la versione 1.1.x del Developer Kit dal sistema, non sarà possibile eseguire quelle applet le cui pagine HTML presentano tag <APPLET>, se sono state avviate da un browser Netscape 4.x. Per eseguire queste applet da un browser Netscape 4.x, è necessario installare Java Plug-in di 1.3 Developer Kit e convertire il file HTML dell'applet in modo da utilizzare Java Plug-in. Le applet avviate da IBM Web Browser per OS/2, funzioneranno senza necessità di apportare modifiche, anche se Java 1.1.x JVM non è installato sul sistema.

### 1.7 Unione di file suddivisi

È possibile unire i file suddivisi utilizzando Merge Utility oppure manualmente mediante una richiesta comandi. Le seguenti sezioni secondarie forniscono le informazioni su come unire i file suddivisi in un unico file da installare.

Prima di iniziare, accertarsi di quanto segue:

- Tutti i file suddivisi relativi ad un particolare componente sono stati scaricati ed è stato utilizzato il nome file corretto. Se non sono state scaricate tutte le parti del pacchetto o se sono stati modificati i nomi dei file, verrà visualizzato un messaggio di errore ed il pacchetto non verrà ricreato.
- Tutti i nomi file e le relative ubicazioni sono stati specificati nell'ordine corretto. Se sono stati modificati i nomi dei file, fornire i nuovi nomi.
- Il nome del file in cui vengono riunite le parti è il nome file completo del pacchetto originale. Ad esempio, il nome file completo di Runtime Environment è javainrt.exe. In tal modo, il programma di utilità Installer riconoscerà il file.

#### Unione dei file suddivisi utilizzando Merge Utility

Prima di avviare il processo di unione dei file suddivisi, scaricare Joiner Utility nella stessa directory in cui sono stati scaricati i file suddivisi. Il nome file è joiner.exe. Joiner Utility contiene Merge Utility, che consente di unire i file suddivisi in un unico file da installare. È possibile che Joiner Utility sia scaricato dalla stessa pagina dei componenti del Developer Kit su Software Choice Catalog of Features.

In una richiesta comandi, digitare `joiner` nella directory in cui è stato scaricato Joiner Utility. Questo comando consente di estrarre Merge Utility (merge.exe) e i file di dati richiesti. Per unire i file suddivisi verrà utilizzato Merge Utility.

In una richiesta comandi, digitare `merge` nella directory in cui è stato scaricato Joiner Utility. In tal modo, vengono ripristinati i pacchetti suddivisi in più parti. Per installare il file, consultare Installazione del Developer Kit.

#### Unione dei file suddivisi manualmente da una richiesta comandi:

1. Accertarsi che siano stati scaricati tutti i file suddivisi relativi al componente da installare nella stessa directory.
2. In una richiesta comandi (dalla directory in cui sono stati scaricati i file suddivisi), digitare i nomi dei file suddivisi e il nome file completo. Ad esempio, per unire i file suddivisi di Runtime Environment, digitare quanto segue:

         copy /b javainrt.ex1 + javainrt.ex2 + javainrt.ex3 + javainrt.ex4 javainrt.exe

In tal modo, vengono ripristinati i pacchetti suddivisi in più parti. Per installare il file, consultare Installazione del Developer Kit.

## 2.0 INSTALLAZIONE DEL DEVELOPER KIT

Nelle seguenti sezioni vengono fornite le istruzioni e le informazioni relative all'installazione del Developer Kit. Prima di installare il Developer Kit o i componenti ad esso associati, consultare la sezione Prima dell'installazione per le informazioni sull'estrazione dei file e sui requisiti di installazione.

### 2.1 Metodo di installazione GUI

È possibile installare il Developer Kit utilizzando il metodo desktop oppure il metodo della richiesta comandi. Per le istruzioni, consultare le relative sezioni.

#### 2.1.1 Metodo desktop

Nota: Se Netscape Communicator è in esecuzione durante l'installazione del Developer Kit, l'installazione avrà esito negativo. È necessario chiudere Netscape Communicator prima di avviare il processo di installazione.

Per eseguire l'installazione utilizzando INSTALL.EXE, attenersi alla seguente procedura:

1. Aprire la cartella Sistema OS/2.
2. Aprire l'oggetto Unità.
3. Aprire l'unità da cui vengono estratti i file del Developer Kit.
4. Aprire la cartella da cui vengono estratti i file del Developer Kit.
5. Fare doppio clic sull'oggetto INSTALL.EXE per avviare il programma di installazione.

Il comando INSTALL.EXE consente di visualizzare una GUI (Graphical User Interface) in cui è possibile definire la lingua di installazione. Selezionare la lingua desiderata. Il programma di installazione guiderà l'utente nella procedura di installazione.

Un Developer Kit per la cartella OS/2 viene creato nella cartella Programmi in OS/2 Warp 4 e sul Desktop per tutte le altre piattaforme supportate.

Una volta completata l'installazione, se si desidera svuotare la directory da cui vengono estratti i file del Developer Kit, selezionare l'oggetto DELINST.CMD dalla cartella del Developer Kit. In tal modo, vengono cancellati i file del Developer Kit e le directory secondarie da cui vengono estratti i file. I file e le directory secondarie non estratti dal Developer non vengono eliminati. È anche possibile eliminare i file scaricati manualmente.

#### 2.1.2 Metodo richiesta comandi

Nota: Se Netscape Communicator è in esecuzione durante l'installazione del Developer Kit, l'installazione avrà esito negativo. È necessario chiudere Netscape Communicator prima di avviare il processo di installazione.

Per avviare l'installazione, verificare che ci si trovi nella directory da cui vengono estratti i file del Developer Kit. Nella richiesta comandi OS/2, digitare:

         INSTALL

Il comando install consente di visualizzare un'interfaccia GUI in cui è possibile indicare la lingua di installazione. Selezionare la lingua desiderata. Il programma di installazione guiderà l'utente nella procedura di installazione.

Un Developer Kit per la cartella OS/2 viene creato nella cartella Programmi in OS/2 Warp 4 e sul Desktop per tutte le altre piattaforme supportate.

Una volta completata l'installazione, se si desidera svuotare la directory da cui vengono estratti i file del Developer Kit, selezionare l'oggetto DELINST.CMD dalla cartella del Developer Kit. In tal modo, vengono cancellati i file del Developer Kit e le directory secondarie da cui vengono estratti i file. I file e le directory secondarie non estratti dal Developer non vengono eliminati. È anche possibile eliminare i file scaricati manualmente.

#### 2.1.3 Componenti non selezionabili durante l'installazione

Se si utilizza l'interfaccia GUI per installare il Developer Kit ed i componenti non selezionabili, è possibile che non sia stato scaricato ed estratto il file ZIP, che contiene il componente necessario. Ritornare alla pagina Software Choice Catalog of Features e scaricare il file ZIP necessario.

Tutti i componenti del Developer Kit richiedono lo scaricamento e l'installazione del componente Runtime Environment (oppure l'installazione precedente del componente Runtime Environment) e il riavvio del sistema.

#### 2.1.4 Ripristino da un'installazione non riuscita

Se l'installazione del Developer Kit ha esito negativo, verificare ed eliminare qualsiasi oggetto di installazione rimanente. Se questi oggetti di installazione non vengono eliminati, le successive installazioni potrebbero avere esito negativo e verrà visualizzato un messaggio che indicherà che uno o più componenti potrebbero non essere installati poiché l'oggetto è in sola lettura o utilizzato da un altro processo.

Per un'installazione CID (Configuration, Installation and Distribution), l'icona relativa all'oggetto di installazione è una casella blu con un nastro rosso ed è posta sul desktop. Per eseguire l'installazione non presidiata, l'oggetto è nella cartella x:\os2\install\ (dove x è l'unità di avvio). Per eliminare l'oggetto, fare clic sull'oggetto utilizzando il pulsante destro del mouse e selezionare Elimina nel menu.

In alternativa, passare alla directory contenente l'oggetto ed eliminare l'intera struttura ad albero di directory. La directory è denominata "Install object" o "Java 1.3 for OS/2".

Una volta eliminato l'oggetto di installazione, chiudere e riavviare il sistema.

#### Impossibile rimuovere l'oggetto di installazione?

Dopo aver eseguito le istruzioni fornite, se l'oggetto di installazione non è stato rimosso, procedere nel modo seguente:

1. Passare ad una richiesta comandi OS/2.
2. Modificare l'unità di avvio e posizionarsi nella directory os2\install.
3. Rimuovere la directory di Java 1.3.1 per OS/2 e tutte le sottodirectory.
4. Riavviare il sistema.

#### 2.1.5 Livello di FixPak corretto ma installazione impossibile

Se si è sicuri che il sistema rilevi i livelli FixPak richiesti, ma non si è in grado di eseguire l'installazione a causa della verifica automatica del FixPak, è possibile disabilitare tale verifica. Per effettuare tale operazione, utilizzare uno dei seguenti metodi:

Primo metodo:

1. Modificare il file CONFIG.SYS aggiungendo l'istruzione JAVANOFPK=YES.
2. Riavviare il sistema e completare di nuovo il processo di installazione per il Developer Kit.

Secondo metodo:

1. Nella directory in cui è stata avviata l'estrazione automatica dei file, posizionarsi nella directory relativa alla lingua da utilizzare.
2. Modificare il file CHECK.CMD. Cercare l'istruzione:

            disablecheck="NO"

   Sostituire "NO" con "YES". (Questa istruzione è contenuta in prossimità della riga 12.)
3. Posizionarsi nuovamente nella directory in cui sono stati estratti i file ed eseguire nuovamente l'estrazione.

### 2.2 Metodo di installazione (CID) non presidiato

Le installazioni CID (configuration, installation and distribution) o non presidiate del Developer Kit vengono gestite da un'interfaccia della riga comandi su Feature Install (CLIFI) ed è possibile che questa operazione impieghi dai 15 ai 20 minuti o più tempo. Una volta terminato il programma di installazione, è necessario che il sistema sia riavviato per terminare l'installazione.

CLIFI richiede due file di risposte: il file di risposte Developer Kit (JAVA131.RSP) ed un file di risposte personalizzato dove gli utenti possano ricoprire le selezioni predefinite. Il file CID.RSP è compreso nel pacchetto di installazione come esempio del file di risposte personalizzato; questo file ed il file CID.CMD devono essere modificati per le installazioni non presidiate.

Nota: Feature Install Versione 1.2.3 o successiva viene richiesto per le installazioni CID non presidiate. Inoltre, se Netscape Communicator è in esecuzione durante l'installazione del Developer Kit, l'installazione avrà esito negativo. È necessario chiudere Netscape Communicator prima di avviare il processo di installazione.

#### 2.2.1 Modifica del file di risposte CID

Il file CID.RSP contiene variabili che consentono di selezionare i componenti da installare, l'unità di destinazione e la directory. Per impostazione predefinita, il file CID.RSP viene impostato per installare tutti i componenti del Developer Kit. È possibile modificare questo file di risposte per selezionare i componenti da installare. Accertarsi di scaricare ed estrarre tutti i file necessari prima di avviare l'installazione. Inoltre, se si installa il Toolkit, installare il Runtime Environment, anche se quest'ultimo è già installato.

Nella seguente tabella vengono elencati i componenti selezionabili ed i nomi delle variabili:

Componente | Variabile
Runtime environment | JV13Runtime
Toolkit | JV13Toolkit
Esempi | JV13Samples
OS/2 Programma di debug ICAT per Java | Programma di debug JV13
Elenco dei componenti selezionabili e dei nomi delle variabili.

Nel file CID.RSP, impostare "selection=1" per ciascun componente da installare ed impostare "selection=0" per ciascun componente che non si desidera installare. Ad esempio, per:

- Installare il componente Runtime Environment e il componente Programma di debug OS/2 ICAT
- Configurare Java Plug-in per Netscape 4.x
- Configurare Java Plug-in per IBM Web Browser per OS/2
- Installare il Developer Kit come JVM predefinita
- Non installare il Toolkit o altri componenti di esempio

Impostare le seguenti variabili come di seguito riportato:

         Java13.Continue=UNATTENDED
         Java13.LicenseAgree=AGREE
         JV13Runtime.Selection=1
         JV13RuntimeConfig.Selection=1
         JV13RuntimeUrls.Selection=1
         JV13NSFiles.Selection=1
         JV13MZFiles.Selection=1
         Java13.RUNDRV=x:
         JV13DefaultJVM.Selection=1
         JV13Samples.Selection=0
         JV13SamplesConfig.Selection=0
         JV13Samplesurls.Selection=0
         JV13Samples.SMPDRV=x:
         JV13Toolkit.Selection=0
         JV13ToolkitConfig.Selection=0
         JV13Debugger.Selection=1
         JV13Debuggerurls.Selection=1
         JV13Debugger.DBGDRV=x:

Questo è un esempio. Per i componenti specifici e le variabili associate, consultare il file CID.RSP. x è l'unità in cui viene installato il componente.

Esiste una variabile JV13xxConfig.Selection associata a ciascuna variabile JV13xx.Selection. La variabile JV13xxConfig.Selection deve essere impostata sullo stesso valore della variabile JV13xx.Selection. Ad esempio, se si imposta JV13Toolkit.Selection=0, è necessario impostare JV13ToolkitConfig.Selection=0 (dove xx è il nome del componente).

Nell'esempio sopra riportato, esistono diverse variabili che devono essere impostate per installare correttamente il Developer Kit. Le variabili e le relative definizioni sono:

JV13.LicenseAgree | Accordo di licenza I valori per questa variabile sono DISAGREE e AGREE. Impostare la variabile su AGREE per indicare che è stato letto l'accordo di licenza e che i termini vengono accettati. Se la variabile non viene impostata su AGREE, il Developer Kit non sarà installato.
JV13DefaultJVM.Selection | JVM Impostare questa variabile sul valore "1" se si desidera installare il Developer Kit come JVM predefinita.
JV13MZFiles | Plug-in per IBM Web Browser per OS/2 Impostare questa variabile sul valore "1" se si desidera configurare Plug-in per IBM Web Browser per OS/2.
JV13NSFiles | Netscape Plug-in Impostare questa variabile sul valore "1" se si desidera configurare Netscape Plug-in.

Per non visualizzare le finestre di conferma durante l'installazione, impostare la seguente variabile come illustrato:

        java13.continue=UNATTENDED

##### 2.2.1.1 Unità di installazione dei componenti

Il Toolkit viene installato nella directory \JAVA13 sull'unità di destinazione. Se si installa il Toolkit, il Runtime Environment viene installato automaticamente sulla stessa unità del Toolkit. Il Runtime Environment è un prerequisito per i componenti Toolkit, Esempi e Programma di debug.

L'unità di destinazione, per i componenti ICAT ed Esempi, viene specificata dall'impostazione dell'unità sui valori desiderati. Se il Developer Kit è presente sull'unità di destinazione, il programma di installazione lo sostituisce.

#### 2.2.2 Avvio dell'installazione non presidiata

Il file CID.CMD contiene un comando CLIFI di esempio per un'installazione CID. Il processo di installazione è stato modificato per comprendere un'installazione multilingue; quindi, è necessario specificare la variabile per la lingua nei file CID.RSP. Vengono elencate di seguito le variabili per la lingua:

Lingua | Variabile per la lingua
Inglese | en
Francese | fr
Tedesco | de
Italiano | it
Giapponese | jp
Portoghese, versione brasiliana | br
Cinese semplificato | cn
Spagnolo | es
Cinese tradizionale | tw
Lingua e relative variabili.

È possibile immettere il comando CLIFI come un comando costituito da una riga singola nella richiesta comandi OS/2, come illustrato di seguito:

         clifi /a:c /r2:cid.rsp /r:xx\JAVA131.rsp /b:c: /s:d:\tmp\xx
         /l1:ciderr.log /l2:cidhist.log

Utilizzare il seguente elenco di variabili come riferimento nell'impostazione delle variabili nei file indicati precedentemente.

dove:

/r2 | Indica l'unità, il percorso e il nome del file di risposte utente.
/r | Indica l'ubicazione completa del file di risposte Feature Install.
xx | Indica la variabile per la lingua desiderata.
/b | Indica l'unità di avvio.
/s | Indica l'ubicazione completa dei file del Developer Kit estratti.
/l1 e /l2 | Indicano le ubicazioni complete dei file di registrazione facoltativi. In caso di errori durante l'installazione, consultare questi file, oltre al file \os2\install\wpinstal.log nell'unità di avvio.

Per non visualizzare le finestre di conferma durante l'installazione, impostare la seguente variabile come illustrato:

        java13.continue=UNATTENDED

#### 2.2.3 Installazione del CID con codice di ritorno "riuscito" e installazione non riuscita

Dopo aver effettuato l'installazione del Developer Kit, se si riceve un codice di ritorno CID "riuscito", ma l'installazione ha avuto esito negativo, è possibile che:

- Non sia stato modificato il file di risposte, accettando ("AGREE") dopo la variabile Java13LicenseAgree.
- Il livello FixPak corretto non sia sul sistema.

È preferibile che i responsabili CID completino un controllo FixPak per verificare che il livello corretto FixPak sia disponibile. Per ulteriori informazioni, consultare la sezione FixPak. È possibile utilizzare il file check.cmd, ubicato nella directory x:\Java131 come esempio di scrittura di uno script che verifica i livelli FixPak. (x:\ è l'unità in cui viene installato il Developer Kit.)

#### 2.2.4 Livello FixPak corretto, ma installazione impossibile

Se si è sicuri che il sistema rilevi i livelli FixPak richiesti, ma non si è in grado di eseguire l'installazione a causa della verifica automatica del FixPak, è possibile disabilitare tale verifica. Per effettuare tale operazione, utilizzare uno dei seguenti metodi:

Primo metodo:

1. Modificare il file CONFIG.SYS aggiungendo l'istruzione JAVANOFPK=YES.
2. Riavviare il sistema e completare di nuovo il processo di installazione per il Developer Kit.

Secondo metodo:

1. Nella directory in cui è stata avviata l'estrazione automatica dei file, posizionarsi nella directory relativa alla lingua da utilizzare.
2. Modificare il file CHECK.CMD. Cercare l'istruzione:

            disablecheck="NO"

   Sostituire "NO" con "YES". (Questa istruzione è contenuta in prossimità della riga 12.)
3. Eseguire di nuovo il processo CID.

### 2.3 NVDM/2 Considerazioni sull'installazione

Un'installazione CID di NetView(R) Distribution Manager/2 (NVDM/2) richiede la creazione di un profilo, la creazione e la catalogazione di un file di modifica. Il profilo NVDM/2 consente di specificare solo un file di risposte; tuttavia, l'installazione automatica del Developer Kit richiede due file di risposte. In NVDM/2, la gestione dell'argomento e della variabile è diversa da quella utilizzata in Feature Install, per installare il Developer Kit.

Nota: Se Netscape Communicator è in esecuzione durante l'installazione del Developer Kit, l'installazione avrà esito negativo. È necessario chiudere Netscape Communicator prima di avviare il processo di installazione.

Nella seguente sezione sono presenti due metodi da utilizzare per installare il Developer Kit utilizzando NVDM/2.

#### 2.3.1 Comando Static nel profilo NVDM/2

Nel profilo NVDM/2, specificare tutte le opzioni CLIFI della variabile PARMS. È necessario che i parametri siano su riga singola e racchiusi tra virgolette doppie:

         Program=c:\os2\install\clifi.exe
         Parms="/a:c /r2:cid.rsp /r:\xx\JAVA131.rsp /b:c: /s:d:\tmp\xx
         /l1:ciderr.log /l2:cidhist.log"

Questo metodo richiede la modifica del profilo quando i nomi della directory di origine oppure del file di registrazione sono modificati. In alternativa, è possibile sostituire tali valori con i valori di variabili specifiche della stazione di lavoro, come illustrato di seguito:

         Program=c:\os2\install\clifi.exe
         Parms="/a:c /r2:$(ResponseFile) /r:$(SourceDir)\xx\JAVA131.rsp
         /b:c: /s:$(SourceDir\xx) /l1:$(LogFile1) /l2:$(LogFile2)"
         ResponseFile=$(WorkstatName).rsp
         SourceDir=d:\tmp
         LogFile1=$(WorkstatName).log
         LogFile2=$(WorkstatName).lg2

Questo secondo metodo richiede un file di risposte separato per ciascuna stazione di lavoro e richiede WorkstatName da impostare appropriatamente.

Utilizzare il seguente elenco di variabili come riferimento nell'impostazione delle variabili nei file indicati precedentemente.

dove:

d: | Indica la directory temp.
/r | Indica l'ubicazione completa del file di risposte Feature Install.
xx | Indica la variabile per la lingua desiderata.
/b | Indica l'unità di avvio.
/s | Indica l'ubicazione completa dei file del Developer Kit estratti.
/l1 e /l2 | Indicano le ubicazioni complete dei file di registrazione facoltativi. In caso di errori durante l'installazione, consultare questi file, oltre al file \os2\install\wpinstal.log nell'unità di avvio.

### 2.4 Installazione del Developer Kit su WorkSpace On-Demand 2.0

Nota: Se Netscape Communicator è in esecuzione durante l'installazione del Developer Kit, l'installazione avrà esito negativo. È necessario chiudere Netscape Communicator e quindi avviare il processo di installazione.

Il prodotto WorkSpace On-Demand 2.0 include Java 1.1.6 per OS/2 Warp. È possibile installare il Developer Kit (Versione 1.3) su server e client WorkSpace On-Demand. Il Developer Kit coesiste con Java 1.1.x per OS/2 Warp. Per le informazioni sull'installazione del Developer Kit sui server e i client WorkSpace On-Demand e del Developer Kit come JVM predefinita, consultare le seguenti sezioni.

#### 2.4.1 Installazione del Developer Kit su un server WorkSpace On-Demand 2.0

Per installare il Developer Kit su un server WorkSpace On-Demand, utilizzare l'interfaccia GUI. Per le istruzioni, consultare la sezione Metodo di installazione GUI.

#### 2.4.2 Installazione del Developer Kit su un client WorkSpace On-Demand 2.0

Per installare il Developer Kit su un client WorkSpace On-Demand, utilizzare un'installazione non presidiata (CID). È possibile utilizzare le istruzioni contenute nella sezione Metodo di installazione non presidiata (CID) ed utilizzare i file CID.CMD e WSOD2.RSP, compresi nel pacchetto di installazione del Developer Kit. La procedura di installazione viene completata su un server WorkSpace On-Demand 2.0.

Nota: Se si desidera installare il Developer Kit come JVM predefinita sui client WorkSpace On-Demand, i riferimenti ai file e alle directory `z:\JAVA131` devono essere ubicati prima dei riferimenti `z:\JAVA11` nel file CONFIG.SYS.

##### 2.4.2.1 Installazione non presidiata per un client WorkSpace On-Demand 2.0

Attenersi alla seguente procedura:

1. Nel file CID.CMD, modificare `/r2:cid.rsp` come `/r2:wsod2.rsp` (dove `/r2` è l'unità, il percorso ed il nome del file di risposte utente).
2. Come descritto nella sezione Avvio dell'installazione non presidiata di questa guida:
   - Sostituire `/s:d:\tmp\xx` nel file CID.CMD con l'unità e la directory in cui viene decompresso il pacchetto di installazione (dove `xx` è la variabile per la lingua desiderata).
   - Verificare che `/b:z` nel file CID.CMD indichi l'unità di avvio del client.
3. Verificare che le selezioni nei file WSOD2.RSP siano appropriate per ciò che si desidera installare. Per impostazione predefinita viene selezionato il Runtime Environment; tutti gli altri componenti sono deselezionati. Accertarsi di scaricare ed estrarre tutti i file necessari. Inoltre, dopo aver letto l'accordo di licenza ed accettato i termini, è necessario che la variabile di selezione Java13.LicenseAgree sia impostata su AGREE nel file WSOD2.RSP. Se questa variabile non viene impostata su AGREE, il Runtime Environment non viene installato.
4. Eseguire il file CID.CMD aggiornato digitando il nome file in una richiesta comandi.

Per completare l'installazione non presidiata, fare riferimento alle seguenti sezioni.

##### 2.4.2.2 Modifica dei file CONFIG.SYS per i client WorkSpace On-Demand 2.0

Per abilitare il componente Runtime Environment del Developer Kit, un responsabile di WorkSpace On-Demand deve apportare le seguenti aggiunte ai file CONFIG.SYS per i client WorkSpace On-Demand:

Aggiungere quanto segue:

`z:\JAVA131\jre\dll` | all'istruzione LIBPATH
`z:\JAVA131\jre\bin;` | all'istruzione SET PATH

È possibile rilevare e modificare il file CONFIG.SYS per i client WorkSpace On-Demand basati sulle seguenti due opzioni:

- Dal server di un utente specifico, il file CONFIG.SYS viene ubicato nella seguente directory ed unità:

         [rpldrive]:\ibmlan\rpl\machines\[nome client]\config.sys

- Per modificare il file CONFIG.SYS predefinito per ciascuna macchina creata, utilizzando la classe di macchina individuale, il file CONFIG.SYS viene ubicato nella seguente directory ed unità:

         [rpldrive]:\ibmlan\rpl\machines\BB20.xx\[classe macchina]\config.sys

dove:

[rpldrive] | Indica l'unità in cui viene installata la directory RPL.
[nome_client] | Indica il nome del client WorkSpace On-Demand.
xx | Indica il codice del paese.
[classe_macchina] | Indica il nome della macchina.

##### 2.4.2.3 Modifica dei file FIT e accesso ai client WorkSpace On-Demand 2.0

Per abilitare il Runtime Environment, un responsabile di WorkSpace On-Demand deve apportare le aggiunte di seguito riportate ai file FIT (File Index Table) per i client WorkSpace On-Demand:

Aggiungere quanto segue:

         z:\JAVA131      BB20.xx\JAVA131

È possibile rilevare e modificare i file FIT per i client WorkSpace On-Demand basati sulle seguenti due opzioni:

- Dal server di un utente specifico, il file [nome_client].FIT viene ubicato nelle seguenti directory ed unità:

         [rpldrive]:\ibmlan\rpl\fits\[nome_client].FIT

- Per modificare il file FIT predefinito, il file DFBB20xx.FIT viene ubicato nelle seguenti directory e unità:

         [rpldrive]:\ibmlan\rpl\fits\DFBB20xx.FIT

Un responsabile WorkSpace On-Demand deve concedere l'accesso in lettura ed esecuzione alla directory JAVA131 per i client WorkSpace On-Demand.

Eseguire i seguenti comandi LAN Server:

      NET ACCESS [rpldrive]\ibmlan\rpl\bb20.xx\JAVA131 /ADD RPLGROUP:RX
      NET ACCESS [rpldrive]\ibmlan\rpl\bb20.xx\JAVA131 /APPLY

dove:

[rpldrive] | Indica l'unità in cui viene installata la directory RPL.
[nome_client] | Indica il nome del client WorkSpace On-Demand.
xx | Indica il codice del paese.

##### 2.4.2.4 Assegnazione della directory USER_HOME per i client WorkSpace On-Demand 2.0

Per la directory USER_HOME per il Developer Kit è necessario l'accesso in lettura e scrittura poiché in questa directory vengono creati i certificati sulla sicurezza e i file proprietà del plug-in. Ad esempio, per specificare `z:\JAVA13_RW` come directory di USER_HOME e dare accesso in lettura e scrittura, aggiungere quanto segue al file FIT (scrivere su un'unica riga):

         z:\JAVA13_RW      \\nome_server\WRKFILES\nome_client\JAVA_RW

Sostituire i nomi dei server e dei client WorkSpace On-Demand per nome_server e nome_client. z è l'unità su cui è installato il Runtime Environment. È possibile immetterlo nel file FIT predefinito.

Un responsabile WorkSpace On-Demand deve inoltre apportare le seguenti modifiche ai file OS2.INI su un client WorkSpace On-Demand. Tutte le aggiunte devono terminare con valore NULL.

Aggiungere quanto segue:

         Application = Java131
         Key = USER_HOME
         Value = z:\JAVA13_RW

Consultare WorkSpace On-Demand Handbook 2.0 per le informazioni su come utilizzare un Editor INI o il comando NET APPPARM da aggiungere alle immissioni del file INI per i client WorkSpace On-Demand. È possibile rilevare il file OS2.INI per i client WorkSpace On-Demand in due modi:

- Dal server per un utente specifico:

           [rpldrive]:\ibmlan\rpluser\[nome client]\os2\os2.ini

- Per modificare il file OS2.INI predefinito per ciascuna macchina creata, utilizzando la classe di macchina individuale, il file OS2.INI viene ubicato nella seguente directory ed unità:

           [rpldrive]:\ibmlan\rpl\machines\BB20.xx\[machine class]\os2\os2.ini

dove:

z | Indica l'unità in cui è installato Runtime Environment sul client.
[rpldrive] | Indica l'unità in cui viene installata la directory RPL.
[nome_client] | Indica il nome del client WorkSpace On-Demand.
xx | Indica il codice paese.
[classe macchina] | Indica il nome di classe della macchina utilizzato da un client WorkSpace On-Demand.

##### 2.4.2.5 Abilitazione dei font per i client WorkSpace On-Demand 2.0

Per abilitare i font relativi al Runtime Environment, un responsabile di WorkSpace On-Demand deve apportare le seguenti aggiunte ai file OS2.INI per i client WorkSpace On-Demand. Tutte le aggiunte devono terminare con valore NULL. z Indica l'unità in cui il Runtime Environment viene installato per il client.

Aggiungere quanto segue:

       Application = PM_Fonts
      Key = courtbi_.ttf
      Value = z:\JAVA131\jre\lib\fonts\COURTBI_.TTF
      Application = PM_Fonts
      Key = courtb_.ttf
      Value = z:\JAVA131\jre\lib\fonts\COURTB_.TTF
      Application = PM_Fonts
      Key = courti_.ttf
      Value = z:\JAVA131\jre\lib\fonts\COURTI_.TTF
      Application = PM_Fonts
      Key = court_.ttf
      Value = z:\JAVA131\jre\lib\fonts\COURT_.TTF
      Application = PM_Fonts
      Key = lucb.ttf
      Value = z:\JAVA131\jre\lib\fonts\LUCB.TTF
      Application = PM_Fonts
      Key = lucbb.ttf
      Value = z:\JAVA131\jre\lib\fonts\LUCBB.TTF
      Application = PM_Fonts
      Key = lucbbi.ttf
      Value = z:\JAVA131\jre\lib\fonts\LUCBBI.TTF
      Application = PM_Fonts
      Key = lucbi.ttf
      Value = z:\JAVA131\jre\lib\fonts\LUCBI.TTF
      Application = PM_Fonts
      Key = lucs.ttf
      Value = z:\JAVA131\jre\lib\fonts\LUCS.TTF
      Application = PM_Fonts
      Key = lucsb.ttf
      Value = z:\JAVA131\jre\lib\fonts\LUCSB.TTF
      Application = PM_Fonts
      Key = lucsbi.ttf
      Value = z:\JAVA131\jre\lib\fonts\LUCSBI.TTF
      Application = PM_Fonts
      Key = lucsi.ttf
      Value = z:\JAVA131\jre\lib\fonts\LUCSI.TTF
      Application = PM_Fonts
      Key = luct.ttf
      Value = z:\JAVA131\jre\lib\fonts\LUCT.TTF
      Application = PM_Fonts
      Key = luctb.ttf
      Value = z:\JAVA131\jre\lib\fonts\LUCTB.TTF
      Application = PM_Fonts
      Key = luctbi.ttf
      Value = z:\JAVA131\jre\lib\fonts\LUCTBI.TTF
      Application = PM_Fonts
      Key = lucti.ttf
      Value = z:\JAVA131\jre\lib\fonts\LUCTI.TTF
      Application = PM_Fonts
      Key = thonbi_.ttf
      Value = z:\JAVA131\jre\lib\fonts\THONBI_.TTF
      Application = PM_Fonts
      Key = thonburi.ttf
      Value = z:\JAVA131\jre\lib\fonts\THONBURI.TTF
      Application = PM_Fonts
      Key = thonb_.ttf
      Value = z:\JAVA131\jre\lib\fonts\THONB_.TTF
      Application = PM_Fonts
      Key = thoni_.ttf
      Value = z:\JAVA131\jre\lib\fonts\Thoni_.TTF

Consultare WorkSpace On-Demand Handbook 2.0 per le informazioni su come utilizzare un Editor INI o il comando NET APPPARM da aggiungere alle immissioni del file INI per i client WorkSpace On-Demand. È possibile rilevare il file OS2.INI per i client WorkSpace On-Demand basato sulle seguenti due opzioni:

- Dal server di un utente specifico, il file OS2.INI viene ubicato nelle seguenti directory ed unità:

         [rpldrive]:\ibmlan\rpluser\[nome client]\os2\os2.ini

- Per modificare il file OS2.INI predefinito per ciascuna macchina creata, utilizzando la classe di macchina individuale, il file OS2.INI viene ubicato nella seguente directory ed unità:

         [rpldrive]:\ibmlan\rpl\machines\BB20.xx\[classe macchina]\os2\os2.ini

dove:

[rpldrive] | Indica l'unità in cui viene installata la directory RPL.
[nome client] | Indica il nome del client WorkSpace On-Demand.
xx | Indica il codice paese.
[classe macchina] | Indica il nome di classe della macchina utilizzato da un client WorkSpace On-Demand.

##### 2.4.2.6 Installazione del plug-in di Netscape Communicator per i client WorkSpace On-Demand 2.0

Per installare Java Plug-in per il browser Netscape 4.x, un responsabile di WorkSpace On-Demand deve copiare il file npjava.dll nella directory del Plug-in di Netscape 4.x dei client WorkSpace On-Demand. Per copiare il file, immettere il seguente comando:

         copy d:\JavaTemp\package\npjava.dll  [rpldrive]:\ibmlan\rpl\bb20.xx\NETSCAPE\PROGRAM\PLUGINS\*.*

Per installare Java Plug-in per IBM web-browser per OS/2, copiare il file npoji6.dll nella directory del Plug-in di Web-browser dei client WorkSpace On-Demand. Per copiare il file, immettere il seguente comando:

         copy d:\JavaTemp\package\npoji6.dll  [rpldrive]:\ibmlan\rpl\bb20.xx\os2\os2web\PLUGINS\*.*

dove:

d:\JavaTemp | Indica l'ubicazione completa dei file del Runtime Environment estratti.
[rpldrive] | Indica l'unità in cui viene installata la directory RPL.
xx | Indica il codice paese.

Inoltre, un responsabile di WorkSpace On-Demand deve apportare la seguente aggiunta ai file OS2.INI per i client WorkSpace On-Demand. Tutte le aggiunte devono terminare con valore NULL.

Aggiungere quanto segue:

         Application = Java Plug-in
         Key = JAVA_HOME
         Value = z:\JAVA131\jre

dove z indica l'unità in cui il Runtime Environment viene installato per il client.

Consultare WorkSpace On-Demand Handbook 2.0 per le informazioni su come utilizzare un Editor INI o il comando NET APPPARM per aggiungere alle immissioni del file INI per i client WorkSpace On-Demand. È possibile rilevare il file OS2.INI per i client WorkSpace On-Demand in due modi:

- Dal server di un utente specifico, il file OS2.INI viene ubicato nelle seguenti directory ed unità:

         [rpldrive]:\ibmlan\rpluser\[nome
    client]\os2\os2.ini

- Per modificare il file OS2.INI predefinito per ciascuna macchina creata, utilizzando la classe di macchina individuale, il file OS2.INI viene ubicato nella seguente directory ed unità:

         [rpldrive]:\ibmlan\rpl\machines\BB20.xx\[classe macchina]\os2\os2.ini

dove:

[rpldrive] | Indica l'unità in cui viene installata la directory RPL.
[nome client] | Indica il nome del client WorkSpace On-Demand.
xx | Indica il codice paese.
[classe macchina] | Indica il nome di classe della macchina utilizzato da un client WorkSpace On-Demand.

##### 2.4.2.7 Installazione dei componenti aggiuntivi del Developer Kit sul client WorkSpace On-Demand 2.0

Se si desidera installare componenti diversi dal Runtime Environment per il client WorkSpace On-Demand, è possibile selezionare questi componenti nel file WSOD2.RSP.

Se si installa il Toolkit, un responsabile di WorkSpace On-Demand deve apportare le seguenti aggiunte ai file CONFIG.SYS per i client:
Aggiungere quanto segue:

`x:\java131\bin;` | all'istruzione SET PATH
`z:\JAVA131\lib;` | all'istruzione SET LIB
`z:\JAVA131\include;` | all'istruzione SET INCLUDE

dove z:\JAVA131 è l'unità e la directory in cui viene installato il Toolkit per il client.

##### 2.4.2.8 Esecuzione degli esempi Java da un client WorkSpace On-Demand 2.0

Il responsabile del server WorkSpace On-Demand deve aggiungere le seguenti righe al file RPL\FITS\client_name.FIT in modo che il client WorkSpace On-Demand sia in grado di eseguire gli esempi forniti nel componente Esempi:

         z:\JAVA131\WEBLOGS \\nome_server\WRKFILES\nome_client\JAVA131\WEBLOGS
         z:\JAVA131\HOTJAVA \\nome_server\WRKFILES\nome_client\JAVA131\HOTJAVA

Sostituire i nomi del server IPL remoto e il client IPL remoto per il nome_server ed il nome_client. z è l'unità in cui viene installato il Developer Kit. È possibile immettere questa opzione nel file FIT predefinito.

I client IPL remoti sono in grado di compilare il codice di esempio se gli esempi vengono posizionati in una directory a cui ha accesso in scrittura il client IPL.

##### 2.4.2.9 Emissione di un trust sui client WorkSpace On-Demand 2.0

Se si emette un trust (accesso) per collegarsi ad un server Web, è necessario che il file IDENTITYDB.OBJ abbia l'accesso in lettura e scrittura. Per creare la connessione, aggiungere quanto riportato al file FIT:

         z:\JAVA131\WEBLOGS        \\nome_server\WRKFILES\nome_client\JAVA131\WEBLOGS
         z:\JAVA131\HOTJAVA        \\nome_server\WRKFILES\nome_client\JAVA131\HOTJAVA
         z:\JAVA131\IDENTITYDB.OBJ \\nome_server\WRKFILES\nome_client\JAVA131\IDENTITYDB.OBJ

##### 2.4.2.10 Il compilatore JIT e un client WorkSpace On-Demand 2.0

In un sistema client WorkSpace on Demand, il seguente comando viene aggiunto al file CONFIG.SYS se la versione 1.1.6 del Developer Kit è stata installata durante l'installazione del server WorkSpace On-Demand:

        set java_compiler=xxx

Questo comando disattiva il compilatore JIT (Just-in-Time).

Per attivare il compilatore JIT, eliminare il comando sopra riportato dal file CONFIG.SYS. È possibile rilevare e modificare il file in base alle due opzioni seguenti:

- Dal server di un utente specifico, il file CONFIG.SYS viene ubicato nella seguente directory ed unità:

         [rpldrive]:\ibmlan\rpl\machines\[classe macchina]\config.sys

- Per modificare il file CONFIG.SYS predefinito per ciascuna macchina creata, utilizzando la classe di macchina individuale, il file CONFIG.SYS viene ubicato nella seguente directory ed unità:

         [rpldrive]:\ibmlan\rpl\machines\BB20.xx\[classe macchina]\config.sys

Utilizzare il seguente elenco di variabili come riferimento nell'impostazione delle variabili nei file menzionati precedentemente:

dove:

[rpldrive] | Indica RPL (Request Parameter List).
xx | Indica il codice paese.
[classe macchina] | Indica il nome di classe della macchina utilizzato da un client WorkSpace On-Demand.

##### 2.4.2.11 Creazione di un'applicazione pubblica di Java Plug-in Control Panel per client WorkSpace On-Demand 2.0

Per creare un'applicazione pubblica per Java Plug-in Control Panel da eseguire su un client WorkSpace On-Demand 2.0, è necessario fornire l'accesso ai file di Netscape. I controlli di accesso vengono specificati nel file APPPOST.FIT di Netscape.

Viene illustrato di seguito come creare un'applicazione pubblica per eseguire Java Plug-in Control Panel:

         net app jctrlpnl /remark:"Java Plug-in Control Panel"
           /appdir:z:\java131\jre\bin
           /command:"jctrlpnl.cmd"
           /type:wsod /interface:pm /add
        net appparm jctrlpnl NCC_POSTFITS=z:\netscape\program\apppost.fit
           /add /placement:b

z:\java131 è l'unità in cui è installata l'immagine di Java Developer Kit e z:\netscape è l'unità in cui è installata l'immagine di Netscape.

### 2.5 Metodo di installazione IPL remota

Un'installazione IPL remota richiede la creazione di due file di risposte e l'impostazione dei file e delle directory appropriate sul server IPL remoto.

Seguire tale procedura per ciascun client da installare:

1. Posizionare i file di installazione del Developer Kit estratti sul server IPL remoto.
2. Eseguire il comando GENFIRPL. Per informazioni, consultare la sezione Creazione dei file di risposte.
3. Eseguire il comando CLIFI per un client IPL remoto. Per informazioni, consultare la sezione Avvio dell'installazione IPL remota.
4. Modificare il file FIT del client. (Consultare le sezioni Aggiornamento dei file per Feature Install e Esecuzione degli esempi Java da un client IPL remoto.)

#### 2.5.1 Creazione dei file di risposte

Dopo aver posizionato i file di installazione del Developer Kit estratti sul server IPL remoto, il comando GENFIRPL viene utilizzato per creare due file di risposte: FILES.RSP per il server IPL remoto e JAVA131.RSP per il client IPL remoto. Di seguito viene riportato un comando GENFIRPL di esempio. Il comando deve essere immesso su riga singola.

         genfirpl /m:c:\javacode\xx  /r:c:\ibmlan\rpl
         /u:c:\ibmlan\rpluser  /f:c:\javacode\xx\JAVA131.rsp
         /c:client_name  /b:x:

Il client IPL remoto non deve essere in esecuzione quando viene emesso il comando GENFIRPL. Un comando GENFIRPL deve essere eseguito per ciascun client IPL remoto, specificando l'unità di avvio ed il nome client appropriato.

Utilizzare il seguente elenco di variabili come riferimento nell'impostazione delle variabili nei file sopra menzionati:

dove:

/m | Indica la directory contenente i file di installazione del Developer Kit sul server IPL remoto.
xx | Indica la variabile per la lingua desiderata.
/r | Indica la directory RPL.
/u | Indica la directory RPLUSER.
/f | Indica il nome completo del file di risposte per il client IPL remoto.
/c | Indica il nome del client IPL remoto.
/b | Indica l'unità di avvio del client IPL remoto.
/nf | Non esegue il trasferimento file Java. Utilizzare questo indicatore durante l'installazione dei client IPL remoti aggiuntivi, dopo il primo, per evitare che i file del Developer Kit siano installati di nuovo per ogni nuovo client.

#### 2.5.2 Modifica del file JAVA131.RSP

Il file JAVA131.RSP contiene variabili che consentono di selezionare i componenti da installare, l'unità di destinazione e la directory. Per impostazione predefinita, il file JAVA131.RSP viene impostato per installare tutti i componenti del Developer Kit. È possibile modificare questo file di risposte per selezionare i componenti da installare. Accertarsi di scaricare ed estrarre tutti i file necessari prima di avviare l'installazione.

Per evitare il troncamento delle righe lunghe in questo file, è necessario utilizzare un editor di testo che gestisca le righe superiori a 255 byte, come TEDIT. Questo file è di grandi dimensioni, è possibile che le modifiche comportino uno spreco di tempo ed errori. Per evitare la perdita di dati, eseguire una copia di riserva del file JAVA131.RSP prima di modificarlo.

#### 2.5.3 Aggiornamento dei file per Feature Install

Il file nome_client.FIT per ciascun client IPL remoto deve essere modificato per comprendere quanto di seguito riportato, che deve essere immesso su una singola riga:

         z:\os2\install\install.inv \\nome_server\WRKFILES\nome_client
         \os2\install\install.inv

Sostituire il nome del server IPL remoto e del client IPL remoto per il nome_server ed il nome_client. z è l'unità in cui viene installato il Developer Kit.

#### 2.5.4 Avvio dell'installazione IPL iniziale remota

Le installazioni RIPL (Remote initial program load) vengono gestite dal programma CLIFI (programma di installazione Feature Install) e potrebbero impiegare tempo. Una volta effettuato il collegamento al server IPL come responsabile, eseguire il comando CLIFI utilizzando il file di risposte creato per il file FILES.RSP del server IPL remoto:

         clifi /a:i  /r:c:\javacode\files.rsp

Questa operazione è necessaria per riavviare il server IPL remoto dopo aver eseguito il programma CLIFI se il trasferimento file non è stato eliminato.

Eseguire il comando CLIFI su ciascun client IPL remoto dopo aver eseguito il comando GENFIRPL per il client.

         clifi /a:i  /r:z:\xx\JAVA131.rsp

Utilizzare il seguente elenco di variabili come riferimento nell'impostazione delle variabili nei file sopra menzionati:

dove:

/r | Indica il nome completo del file di risposte del client IPL remoto come specificato sul comando GENFICMD.
xx | Indica la variabile per la lingua desiderata.

#### 2.5.5 Esecuzione degli esempi Java da un client IPL remoto

Il responsabile del server IPL remoto deve aggiungere le seguenti righe al file RPL\FITS\nome_client.FIT in modo che il client IPL remoto sia in grado di eseguire gli esempi forniti nel componente Esempi:

         z:\JAVA131\WEBLOGS \\nome_server\WRKFILES\nome_client\JAVA131\WEBLOGS     z:\JAVA131\HOTJAVA \\nome_server\WRKFILES\nome_client\JAVA131\HOTJAVA

Sostituire i nomi del server IPL remoto e del client IPL remoto per il nome_server ed il nome_client. z è l'unità in cui viene installato il Developer Kit.

I client IPL remoti sono in grado di compilare il codice di esempio, se gli esempi vengono posizionati in una directory a cui ha accesso in scrittura il client IPL.

##### 2.5.5.1 Emissione di un trust su un client IPL remoto

Se si emette un trust per collegarsi ad un server Web, è necessario che il file IDENTITYDB.OBJ abbia l'accesso in lettura e scrittura. Per creare la connessione, aggiungere quanto riportato al file FIT:

         z:\JAVA131\WEBLOGS \\nome_server\WRKFILES\nome_client\JAVA131\WEBLOGS     z:\JAVA131\HOTJAVA \\nome_server\WRKFILES\nome_client\JAVA131\HOTJAVA
         z:\JAVA131\IDENTITYDB.OBJ  \\server\WRKF\client\JAVA131\IDENTITYDB.OBJ

Sostituire i nomi del server IPL remoto e del client IPL remoto per il nome_server ed il nome_client. z è l'unità in cui viene installato il Developer Kit.

È possibile che sia immesso nel file FIT predefinito come parte dell'installazione del Developer Kit per WorkSpace On-Demand durante l'esecuzione del comando WSOD.CMD.

## 3.0 DOPO L'INSTALLAZIONE

Le seguenti sezioni forniscono informazioni aggiuntive che possono risultare utili dopo aver installato il Developer Kit.

### 3.1 Origini aggiuntive delle informazioni

Gli oggetti contenuti nel seguente elenco vengono visualizzati nella cartella Developer Kit OS/2 solo se è in esecuzione OS/2 Warp 4. Se è in esecuzione OS/2 Warp Server per e-business, è possibile accedere ai documenti associati nelle ubicazioni illustrate.

- IBM Center per Java Technology:
  http://www.ibm.com/java/jdk/index.html
- Documentazione Java:
  http://www.javasoft.com/doc.html
- Programma di debug ICAT per OS/2 Java:
  `x:\JAVA131\ICATJAVA\help\icatjvo.htm`
- README del Developer Kit
  `x:\JAVA131\`

x è l'unità in cui viene installato il Developer Kit.

Se è stato installato il Toolkit o il programma di debug ICAT per componenti Java OS/2 in directory diverse rispetto al componente Runtime Environment, specificare la directory appropriata per questi due oggetti. I collegamenti alla documentazione di Runtime Environment e al Programma di debug ICAT per OS/2 Java non funzionano se i componenti sono contenuti in directory diverse o non sono installati.

### 3.2 Installazione dei componenti aggiuntivi

Dopo aver effettuato l'installazione iniziale del Developer Kit, è possibile installare componenti aggiuntivi, effettuando di nuovo la procedura di installazione. Ciò richiede di scaricare i file dal sito Web Software Choice, conservare tutti i file estratti sul sistema oppure conservare i file compressi originali ed estrarre i file quando è necessario.

### 3.3 Considerazioni su TextField e TextArea AWT

I controlli TextField e TextArea AWT (Abstract Window Toolkit) non supportano caratteri esterni alla code page corrente. Per visualizzare i caratteri di lingua aggiuntivi, gli utenti che operano sui sistemi in lingua inglese/americano possono passare alla code page 850 (la code page multilingue, che supporta le lingue dell'Europa Occidentale).

### 3.4 Modifica dei file di proprietà font non supportata

La modifica dei file delle proprietà font, fornite con il Developer Kit, non viene supportata.

### 3.5 Problemi di tempo nelle applet Java

Se si verificano problemi di tempo nelle applet Java, è necessario impostare o modificare la variabile di fuso orario (TZ). Per impostare la variabile TZ, effettuare una delle seguenti azioni:

- Passare alla pagina generale nel pannello di configurazione TCP/IP. Impostare il campo del fuso orario utilizzando la guida in linea.
- Modificare il file CONFIG.SYS ed aggiungere o modificare l'istruzione SET TZ=.

### 3.6 Utilizzo di OS/2 HMS (High Memory Support) per aumentare JHS (Java heap size)

In un ambiente OS/2 standard, lo spazio massimo di indirizzo virtuale disponibile su un'applicazione è di 512 MB e la memoria disponibile per la dimensione Java è limitata a circa 256 MB. Questa limitazione può essere modificata utilizzando OS/2 HMS (OS/2 High Memory Support). OS/2 HMS aumenta lo spazio massimo di indirizzo virtuale disponibile su un'applicazione a 3 GB.

Le seguenti piattaforme supportano OS/2 HMS:

- Server WorkSpace On-Demand
- OS/2 Warp Server per e-business

#### 3.6.1 Abilitazione di OS/2 HMS

HM (High Memory) disponibile è controllata dall'impostazione VIRTUALADDRESSLIMIT, contenuta nel file CONFIG.SYS. Nel file CONFIG.SYS, il valore viene espresso in MB. Ad esempio:

            VIRTUALADDRESSLIMIT=2048

Il valore minimo consentito è di 512 MB. Questo valore garantisce la compatibilità con le versioni precedenti di OS/2 che hanno un accesso consentito di 512 MB. I valori superiori ai 512 MB possono diminuire il numero di processi che sono in esecuzione sul sistema correntemente.

#### 3.6.2 Abilitazione di JHS (Java Heap Size) per utilizzare OS/2 HMS

Per indicare al JVM (Java Virtual Machine) di posizionarsi in OS/2 HMS, impostare la seguente variabile di ambiente:

        SET JAVA_HIGH_MEMORY=1

Se OS/2 HMS non è disponibile, questa opzione viene ignorata e l'heap viene assegnato dallo spazio di indirizzo standard.

#### 3.6.3 Limitazioni durante l'utilizzo di OS/2 HMS

Se l'heap Java viene posizionato in OS/2 HMS, gli oggetti assegnati non sono accessibili alla codifica a 16 bit. Questo problema si verifica solo se un'applicazione Java dispone di DLL originali che sono compilate mediante un compilatore a 16 bit oppure se vengono richiamate altre DLL che contengono la codifica a 16 bit.

### 3.7 Classe BigDecimal avanzata

Questo rilascio include la classe BigDecimal (com.ibm.math.BigDecimal). Esso viene fornito (con la relativa classe di supporto MathContext) come alternativa alla classe java.math.BigDecimal. Se si utilizza la classe java.math.BigDecimal in un programma Java e si desidera accedere alla nuova classe, è necessario modificare l'istruzione import nella codifica di origine come illustrato di seguito.

Modificare:

         import java.math.*;

Come:

         import com.ibm.math*;

Non è necessario modificare altre codifiche.

### 3.8 Java Plug-in

Le seguenti sezioni forniscono informazioni sull'installazione e l'uso di Java Plug-in per Netscape 4.x e IBM Web Browser per OS/2.

#### 3.8.1 Installazione di Java Plug-in dopo l'installazione di Netscape Communicator

Se è stato installato Netscape Communicator dopo il Developer Kit e si desidera abilitare Java Plug-in, completare la seguente procedura:

1. Individuare il file plugin.exe ubicato nella directory \JAVA131\ns\ del Runtime Environment. Copiare il file plugin.exe in una directory temporanea.
2. Dalla directory in cui è stato copiato il file plugin.exe, eseguire il file plugin.exe digitando il nome file in una richiesta comandi. L'esecuzione del file estrae i seguenti file:
   - instplug.cmd: Comando CLIFI usato per eseguire l'installazione di Java plug-in
   - npjava.dll: Java Plug-in dll
   - nscheck2.exe: Uscita utente utilizzata per individuare Netscape
   - nsfiles.rsp: File di risposte FI (Feature Install). Non modificare questo file.
   - nsuser.rsp: File di risposte dell'utente parziale dimostrativo
   - package.ctl: Un file pacchetto richiesto dal file FI.
3. Ritornare alla directory \JAVA131\ns\.
4. Modificare il file instplug.cmd per posizionare i percorsi e l'unità di avvio corretti.
5. Modificare il file nsuser.rsp per abilitare Java Plug-in. Viene abilitata la versione aggiornata di Netscape Communicator. Per abilitare una versione specifica di Netscape, impostare il valore JAVANSFILES.NSDRV contenuto nel file nsuser.rsp sul nome completo dell'unità e della directory.
6. Eseguire il file instplug.cmd.
7. Riavviare il sistema.

Utilizzare il seguente elenco di variabili come riferimento nell'impostazione delle variabili nei file sopra menzionati.

dove:

xx | Indica la variabile per la lingua desiderata.
/r | Indica l'ubicazione completa del file di risposte Feature Install.
/r2 | Indica l'unità, il percorso e il nome del file di risposte utente.
/b | Indica l'unità di avvio.
/s | Indica l'ubicazione completa dei file del Developer Kit estratti.
/l1 e /l2 | Indicano le ubicazioni complete dei file di registrazione facoltativi. In caso di errori durante l'installazione, consultare questi file, oltre al file \os2\install\wpinstal.log nell'unità di avvio.

#### 3.8.2 Installazione di Java Plug-in dopo l'installazione di IBM Web Browser per OS/2

Se è stato installato IBM Web Browser per OS/2 dopo il Developer Kit e si desidera abilitare Java Plug-in per tale browser, completare la seguente procedura:

1. Individuare il file mzplugin.exe ubicato nella directory \JAVA131\ns\ del Runtime Environment. Copiare il file mzplugin.exe in una directory temporanea.
2. Dalla directory in cui è stato copiato il file mzplugin.exe, eseguire il file mzplugin.exe digitando il nome file in una richiesta comandi. L'esecuzione del file estrae i seguenti file:

- insmzplg.cmd: Comando CLIFI usato per eseguire l'installazione di Java plug-in
- npoji6.dll: file dll di Java Plug-in
- mzcheck2.exe: Uscita utente usata per individuare Netscape
- mzfiles.rsp: file di risposte FI (Feature Install). Non modificare questo file.
- mzuser.rsp: file di risposte dell'utente di esempi parziali
- package.ctl: Un file pacchetto richiesto dal file FI.

3. Ritornare alla directory \JAVA131\ns\.
4. Modificare il file insmzplg.cmd in modo che punti i percorsi e le unità di avvio corretti.
5. Modificare il file mzuser.rsp per abilitare Java Plug-in. Viene abilitata la versione aggiornata di IBM Web Browser per OS/2. Per abilitare una versione specifica di IBM Web Browser per OS/2, impostare il valore JAVAMZFILES.NSDRV contenuto nel file mzuser.rsp sul nome completo dell'unità e della directory.)
6. Eseguire il file insmzplg.cmd.
7. Riavviare il sistema.

Utilizzare il seguente elenco di variabili come riferimento nell'impostazione delle variabili nei file sopra menzionati.
dove:

xx | Indica la variabile per la lingua desiderata.
/r | Indica l'ubicazione completa del file di risposte Feature Install.
/r2 | Indica l'unità, il percorso e il nome del file di risposte utente.
/b | Indica l'unità di avvio.
/s | Indica l'ubicazione completa dei file del Developer Kit estratti.
/l1 e /l2 | Indicano le ubicazioni complete dei file di registrazione facoltativi. In caso di errori durante l'installazione, consultare questi file, oltre al file \os2\install\wpinstal.log nell'unità di avvio.

#### 3.8.3 Java Plug-in Control Panel

Una volta installato Java Plug-in, è possibile controllarne il comportamento in fase runtime. Ad esempio, quando si esegue il plug-in è possibile specificare se avviare la console Java all'avvio di Java Plug-in.

Control Panel è un'applicazione Java avviata dal file di comandi ubicato nel file [x:\JAVA131]\jre\bin\jctrlpnl.cmd. L'icona per questo file di comandi si trova nella directory [x:\JAVA13] dove x è l'unità in cui è stato installato il Developer Kit. Per impostazione predefinita, JAVA131 è il nome della directory.

### 3.9 Disattivazione del compilatore JIT

Un compilatore JIT (Just-in-Time) viene fornito con il Developer Kit. Il compilatore JIT crea un codice macchina per le sequenze di codici di byte di uso frequente nelle applet o applicazioni Java durante l'esecuzione. Per impostazione predefinita, il compilatore JIT è abilitato. Per individuare un problema relativo ad un'applicazione Java, ad un'applet o al compilatore stesso, è possibile disabilitare il compilatore JIT, trasferendo il seguente comando all'interprete runtime Java.

    SET JAVA_COMPILER=none

### 3.10 Modifica del nome file

Esistono alcuni nomi file brevi basati sulla convenzione per i nomi file 8.3, richiesti dal sistema operativo OS/2 che sono diversi dai nomi file lunghi, richiesti da alcune piatteforme come Microsoft(R) Windows(R) o Linux. Di seguito vengono riportati i nomi file noti diversi:

Nome file lungo | Nome file breve OS/2
cmm.dll | orb.dll
fontmanager.dll | font.dll
ioser12.dll | iosr12.dll
java-rmi.exe | jrmi.exe
| policytool.exe | policy.exe

keytool.exe | keytol.exe
appletviewer.exe | applet.exe
tnameserv.exe | tnames.exe
rmiregistry.exe | rmireg.exe
.keystore | keystore.prp
Nomi lunghi e abbreviati che differiscono dalla convenzione per l'assegnazione dei nomi file 8.3.

### 3.11 Configurazione del Programma di visualizzazione applet

Per impostare il programma di visualizzazione dell'applet collegarsi mediante un gateway proxy ad Internet:

1. Fare clic su Proprietà dell'applet.
2. fare clic su Proprietà.
3. Digitare il server proxy e la porta proxy nei campi corrispondenti
Ad esempio:

         Server proxy Http: myproxy.mycompany.com
         Porta proxy Http:   80

Se il browser Web è già configurato per collegarsi ad Internet, utilizzare i valori impostati nella configurazione. Ad esempio, con WebExplorer(R), utilizzare i valori Gateway Proxy nella pagina Configura server, omettendo la parte iniziale 'http://' e la parte finale '/'.
Se il Gateway Proxy non è noto, rivolgersi al responsabile di sistema per ottenere l'autorizzazione ad utilizzare i servizi proxy.
4. Per rendere effettive le modifiche, fare clic su Applica.
5. Chiudere il programma di visualizzazione applet.

### 3.12 Specifica delle proprietà di sistema e delle opzioni Java

È possibile specificare le opzioni Java e le proprietà di sistema creando una variabile di ambiente definita IBM_JAVA_OPTIONS e impostandola sui valori richiesti. Qualsiasi opzione Java o proprietà di sistema specificate devono essere precedute da uno spazio, eccetto per la prima opzione. Ad esempio, è possibile impostare IBM_JAVA_OPTIONS come segue:

    IBM_JAVA_OPTIONS=-Dmysysprop1=tcpip -Dmysysprop2=wait

Se vengono specificate le stesse opzioni o proprietà dalla riga comandi (o da un programma JNI), esse saranno impostate prima delle opzioni e proprietà specificate dalla variabile di ambiente IBM_JAVA_OPTIONS. L'unica eccezione di questa regola è presente quando sono specificati -Xt, -Xtm o -Xdebug. In questi casi, non dovrebbe essere utilizzato alcun JIT.

Tenere presente che:

- IBM_JAVA_OPTIONS non avrà effetto durante l'esecuzione con JNI_VERSION_1_1.
- Le opzioni Java devono essere specificate nel formato corrente, ad esempio, -verbose:gc piuttosto che -verbosegc.

La proprietà del sistema ibm.jvm.bootclasspath consente di definire un ulteriore percorso di ricerca. Il valore di tale proprietà è inserito tra un valore qualunque definito da -Xbootclasspath/p: ed il percorso bootclass. Il percorso bootclass può essere quello predefinito oppure quello definito con l'opzione -Xbootclasspath:. Per ulteriori informazioni relative a tali opzioni, consultare la sezione 3.1 Origini aggiuntive delle informazioni

### 3.13 RMI su IIOP

RMI (Remote Method Invocation) di Java fornisce un semplice meccanismo per effettuare la programmazione Java distribuita. RMI-IIOP (RMI over IIOP) potenzia RMI Java di base per effettuare la comunicazione utilizzando il protocollo IIOP (Inter-ORB Protocol) standard del CORBA (Common Object Request Broker Architecture). Esso consente di interagire direttamente con altri ORB (Object Request Brokers) del CORBA, se essi sono stati implementati in Java o in un altro linguaggio di programmazione.

Il Developer Kit include il supporto per le applicazioni che utilizzano RMI-IIOP (RMI over IIOP). Questo supporto è parte dell'installazione di Runtime Environment standard e non richiede speciali impostazioni o configurazioni.

#### 3.13.1 Compilatore IDL-Java

Insieme a questo rilascio viene fornito un compilatore IDL-Java. Questo strumento converte in Java il linguaggio IDL (Interface Definition Language) del CORBA. Per ulteriori informazioni, consultare la Guida per l'utente del compilatore IDL-Java. È possibile rilevare questa documentazione nella seguente directory:

         [x:\JAVA131]\DOCS\RMI-IIOP\toJavaPortableUG.htm

[x:\JAVA131] è l'unità e la directory in cui viene installato il Developer Kit. Per impostazione predefinita, JAVA131 è il nome della directory.

Il compilatore IDL-Java supporta la specifica CORBA 2.3. Include "valuetype" e la relativa corrispondenza IDL-Java. Le informazioni dettagliate relative a questo supporto possono essere rilevate ai seguenti siti FTP:

- ftp://ftp.omg.org/
  Dalla pagina principale, fare clic su pub --> docs --> formal --> 99-07-53.pdf
  (corrispondenza IDL-Java)
- ftp://ftp.omg.org/
  Dalla pagina principale, fare clic su pub --> docs --> formal --> 98-12-01.pdf
  (nucleo CORBA 2.3)

Il compilatore IDL-Java viene fornito in modo da poter operare con l'IDL creato dal comando "rmic -idl". Questo IDL creato ed il compilatore IDL-Java non sono richiesti durante l'utilizzo di RMI-IIOP in Java. L'IDL creato viene utilizzato per consentire a RMI-IIOP di operare con altri linguaggi, come C++. Per l'utilizzo con C++, un compilatore IDL su C++ che supporta la specifica CORBA 2.3 deve essere utilizzato per compilare IDL creato.

##### 3.13.1.1 Limitazioni sul compilatore IDL-Java

Quando si effettua l'installazione del compilatore IDL-Java è opportuno tener presente le seguenti considerazioni:

- È possibile che gli identificatori salvati nell'ambito globale non abbiano la stessa ortografia come tipi primitivi IDL, Object o ValueBase. Questa condizione si verifica poiché la tabella dei simboli viene precaricata con questi identificatori; consentendo la relativa ridefinizione.
- Non sono presenti matrici locali e non viene copiata la semantica durante il trasferimento dei valori.
- Il tipo IDL regolato non viene supportato.
- Gli stub creati non supportano la serializzazione. Ciò è dovuto alle caratteristiche della corrispondenza IDL e Java 1998-08-22 sezione 25.3.1.3 che non consente di effettuare richieste specifiche.
- Le costanti del tipo octet non possono essere dichiarate.

##### 3.13.1.2 Problemi noti relativi al compilatore IDL-Java

Di seguito vengono riportati i problemi noti del compilatore IDL-Java:

- Il compilatore potrebbe completare il processo di compilazione senza errori, ma non riesce a generare l'emissione. Se si verifica questa condizione, specificare l'opzione -emitAll per forzare tutte le classi da generare. Quando si utilizza l'opzione -emitAll, è preferibile utilizzare l'opzione-pkgPrefix per aggiungere un prefisso a qualsiasi nome di classe che inizia con 'java' per evitare i conflitti di denominazione con le classi in JVM.
- Il compilatore non riconosce il tipo CORBA::Principal deprecato.
- La dichiarazione di una costante e di un attributo o metodo, che ha lo stesso nome nello stesso ambito non provoca errori. Il seguente IDL potrebbe causare un errore:

               interface t {
                 const long foo = 1;
                 attribute long foo;
               };

- Nel seguente IDL risulta un errore relativo a "S is an undeclared type" nell'interfaccia B. L'errore non deve esistere.

               interface A { struct S { short s; }; };
               interface B:A { typedef S new_S;
                           exception ex {S f1;}; // Error for "S" here
               };

- Se un'unione definisce un'altra unione nella clausola predefinita, la classe Java risultante restituirà errori di compilazione. Una possibile soluzione consiste nel definire l'unione annidata all'esterno dell'unione che la contiene.

#### 3.13.2 Informazioni aggiuntive

Per informazioni su IBM e RMI-IIOP, consultare il seguente sito Web IBM:
http://www.ibm.com/java/jdk/rmi-iiop/index.html

Altre documentazioni disponibili:

- Il README del Developer Kit ubicato nella directory in cui viene installato il Developer Kit.
- La pubblicazione RMI-IIOP Programmer's Guide è un'introduzione alla scrittura dei programmi RMI-IIOP e viene rilevata al seguente sito Web o directory e file:

- http://www.ibm.com/java/jdk/rmi-iiop/docs/win130/rmi_iiop_pg.html
- [x:\JAVA131]\DOCS\RMI-IIOP\rmi_iiop_pg.html

- La Guida per l'utente del compilatore IDL-Java descrive come utilizzare lo strumento che crea la codifica Java dall'IDL e viene rilevata al seguente sito Web o directory e file:
  - http://www.ibm.com/java/jdk/rmi-iiop/docs/win130/toJavaPortableUG.htm
  - [x:\JAVA131]\DOCS\RMI-IIOP\toJavaPortableUG.htm
- La directory di esempio contiene:
  - un esempio Hello World che è intercambiabile tra i protocolli JRMP e IIOP. ([x:/JAVA131]/rmi-iiop/samples/Hello)
  - Un esempio Hello World che opera con un programma IDL standard. ([x:/JAVA131]/rmi-iiop/samples/idl)

  [x:\JAVA131] è l'unità e la directory in cui viene installato il Developer Kit. Per impostazione predefinita, JAVA131 è il nome della directory.

- Il documento Java Language to IDL Mapping è una specifica tecnica dettagliata di RMI-IIOP e può essere rilevata al seguente sito FTP:
  ftp://ftp.omg.org/
  Dalla pagina principale, fare clic su pub --> docs --> formal --> 99-07-59.pdf
- Le informazioni relative all'API (Application Programming Interface) Java si trovano al seguente sito Web: http://java.sun.com/products/?frontpage-main

#### 3.13.3 Termini RMI-IIOP

API | Application Programming Interface
CORBA | Common Object Request Broker Architecture
IDL | Interface Definition Language
IIOP | Internet Inter-ORB Protocol
| ORB | Object Request Broker

RMI | Remote Method Invocation

### 3.14 JAAS (Java Authentication e Authorization Service)

La piattaforma Java 2 fornisce un mezzo per rafforzare i controlli di accesso basati sull'origine del codice e sull'identità del firmatario. Questi controlli di accesso sono necessari a causa della natura distribuita della piattaforma Java dove, ad esempio, è possibile che un'applet remota sia scaricata su una rete pubblica e poi eseguita localmente.

Tuttavia, la piattaforma Java 2 non fornisce un modo per forzare controlli di accesso simili basati su chi esegue il codice. Per fornire questo tipo di controllo accessi, l'architettura di sicurezza Java 2 richiede quanto segue:

- Supporto aggiuntivo per l'autenticazione (determinare l'esecutore del codice)
- Estensioni per i componenti di autorizzazione esistenti per forzare i nuovi controlli di accesso basati su chi è stato autenticato

Il framework JAAS (Java Authentication e Authorization Service) fornisce questi potenziamenti.

Per una panoramica generale di JAAS, consultare il seguente sito Web:

http://java.sun.com

Nella pagina principale fare clic su Prodotti & API e individuare la sezione Pacchetti facoltativi in basso. I documenti contenuti in questo sito Web contengono collegamenti a molte altre sorgenti di informazioni basate su Web.

#### 3.14.1 Differenza tra le versioni IBM e Sun di JAAS

La versione IBM di JAAS per OS/2 è diversa dalla versione Sun di JAAS per Windows e richiede che i pacchetti com.sun.* siano spostati nei pacchetti com.ibm.*.

#### 3.14.2 Installazione di base

Di seguito vengono riportate le informazioni sull'ubicazione dei file JAAS:

- I file jaas.jar e jaas_lm.jar sono contenuti nella sottodirectory jre\lib\ext della directory in cui viene installato il Runtime Environment
.
- JAAS include un semplice LoginModule che visualizza le informazioni di collegamento del sistema operativo sui programmi Java. Per eseguire tale operazione, i seguenti file vengono installati nelle sottodirectory visualizzate, nella directory in cui viene installato Runtime Environment:

             JAVA131\jre\bin:
                       jaas.dll
                       jaas_g.dll

- La directory di documentazione JAVA13\docs\jaas contiene la documentazione JAAS API ed il file module.html. Nella directory della documentazione JAAS, individuare il file JaasDocs.jar contenente la documentazione JAAS API ed eseguire, in una partizione HPFS o JFS, il comando jar -xvf JaasDocs.Jar. Individuare il file index.html. Mediante un browser, utilizzare il file index.html per accedere alla documentazione API.

Nota: Il Runtime Environment è installato nella directory x:\JAVA131, dove x è l'unità in cui è stato installato il Developer Kit. Per impostazione predefinita, JAVA131 è il nome della directory.

### 3.15 Informazioni sulla programmazione JNI

È possibile accedere agli oggetti Java da un programma C utilizzando JNI (Java Native Interface), la nuova interfaccia fornita con Java 1.1.1. JNI è un'interfaccia più stabile della precedente NMI (Native Method Interface).

Le applicazioni JNI in genere richiedono l'interazione con i tipi Java long, float e double per i seguenti motivi:

- Per ricevere le variabili come parametri di metodo nativi.
- Per analizzare e modificare direttamente le variabili di classe o istruzione.
- Per restituire la variabile come valore di ritorno del metodo nativo.
- Per passare le variabili come dati di parametro quando si richiamano altri metodi Java da un metodo nativo.

### Tipi nativi di JNI

Per ognuno dei tipi Java, l'interfaccia JNI fornisce tipi nativi che è possibile utilizzare nell'applicazione JNI. Tali tipi sono illustrati nella seguente tabella:

Tipi nativi di JNI
Tipo Java | Tipo nativo di JNI | Dimensione in byte
--- | --- | ---
long | jlong | 8
double | jdouble | 8
float | jfloat | 4
Tipi JNI nativi

Nota: Non è necessario utilizzare questi tipi se le applicazioni in uso non gestiscono i tipi Java long, double e float.

Utilizzare i tipi nativi di JNI quando si definisce l'implementazione di un metodo nativo in modo che il compilatore associ la firma del metodo nativo con quella del file di intestazioni generato mediante il programma di utilità javah.

### Funzioni di supporto e macro

I tipi nativi di JNI jlong, jdouble e jfloat sono incompatibili con i rispettivi tipi C e C++ long, double e float. Se si tenta di associare gli uni agli altri, si otterrà un errore di compilazione o un comportamento imprevisto nella fase di runtime. Non tentare di eseguire conversioni dei tipi in quanto i formati dei tipi nativi di JNI sono specifici per il Developer Kit.

Il file di intestazioni di JNI (jni.h) include un altro file di intestazioni fornito con il Developer Kit e denominato int64_md.h. Tale file definisce le funzioni di supporto e le macro che è possibile utilizzare con i tipi nativi.

Le funzioni e le macro in int64_md.h (relative a jlong) in genere includono ll all'inizio o alla fine del nome. Le funzioni relative a jdouble o jfloat in genere includono dbl, double, flt o float nel nome. Vi sono anche alcune costanti jlong, jdouble e jfloat definite.

Di seguito sono riportati esempi di macro:

- La macro ll_add() aggiunge due jlong e restituisce un jlong.
- La macro int2ll() converte un int in un jlong.
- La funzione ll2str() converte un jlong in una rappresentazione in stringa ASCII del valore di 64 bit.
- La funzione flt2dbl() converte un jfloat e restituisce un jdouble.
- La macro dbl2nat() converte un jdouble in un double nativo OS/2.
.
- La macro dbl_sqrt() prende la radice quadrata di un jdouble e restituisce un jdouble.
- Le funzioni dbl2str() e flt2str() convertono i rispettivi argomenti in una rappresentazione di stringa ASCII.

### 3.16 Considerazioni sulle prestazioni

Alcune applicazioni potrebbero impiegare più tempo ad essere caricate o avviate su OS/2 Warp Development Kit, Java 2 Technology Edition, versione 1.3.1 rispetto alla versione 1.3.0. In questi casi, può essere utile il parametro -Xquickstart della riga comandi JAVA.EXE.

Il programma di compilazione Just-In-Time di OS/2 Java 1.3.1 esegue, per impostazione predefinita, le ottimizzazioni aggiuntive che potrebbero aumentare il tempo necessario per il caricamento di un'applicazione. Lo scopo delle ottimizzazioni è quello di migliorare le prestazioni di runtime dell'applicazione. Il miglioramento apportato alle prestazioni di runtime e il periodo di tempo necessario per il caricamento variano da un'applicazione all'altra. Alcune applicazioni mostrano solo poche differenze rispetto a Java 1.3.0. Il parametro -Xquickstart specifica l'uso di un insieme di ottimizzazioni semplificato che dovrebbe migliorare i tempi di avvio. Le differenze di prestazioni evidenti quando si utilizza o meno -Xquickstart variano in base all'applicazione.

## 4.0 PACCHETTI FONT AGGIUNTIVI

Se uno o più pacchetti font sono stati scaricati come file singolo, per le istruzioni sull'installazione passare alle sezioni Installazione dei font aggiuntivi. Se sono stati scaricati file suddivisi, seguire questa procedura per unire i file suddivisi in un file da installare. Quindi, continuare con le sezioni di installazione.

1. Verificare che i file suddivisi per il font desiderato siano contenuti nella stessa directory.
2. In una richiesta comandi e dalla directory in cui sono stati scaricati i file suddivisi, utilizzare il comando copy per unire i file. È necessario includere i nomi dei file suddivisi ed il nome file per il font completo. Ad esempio, se sono stati scaricati tre file suddivisi, digitare quanto segue:

         Copy /b ExamFont.txx + ExamFont.txx + ExamFont.txx ExamFont.ttf

dove:

ExamFont.txx | è il nome del file suddiviso scaricato. (xx è il numero del file suddiviso scaricato.) Specificare i file suddivisi nell'ordine corretto.
ExamFont.ttf | è il nome completo del font.

### 4.1 Installazione dei font aggiuntivi

Per le informazioni sull'installazione, consultare le seguenti sezioni utilizzando il metodo di installazione CID o il metodo Tavolozza font.

#### 4.1.1 Metodo di installazione CID

Per installare un font aggiuntivo utilizzando un'installazione CID, seguire tale procedura:

1. Individuare il file wtfont.exe ubicato nella directory x:\JAVA131\fonti del Developer Kit. x è l'unità in cui viene installato il Developer Kit.
2. Eseguire il file wtfont.exe digitando il nome file in una richiesta comandi. L'esecuzione del file estrae i seguenti file:

- wtfnt.cmd: Un file di comando che esegue CLIFI.
- wtfonts.rsp: File di risposta FI (Feature Install). Non modificare questo file.
- wtfntusr.rsp: Un file di risposta utente. Modificarlo per selezionare i font da installare.
- PACKAGE.CTL: Un file di impacchettamento richiesto da Feature Install.

3. Copiare il file PACKAGE.CTL nella directory in cui sono stati scaricati i pacchetti dei font aggiuntivi.
4. Modificare il file wtfnt.cmd per posizionare i percorsi e l'unità di avvio corretti. Consultare quanto riportato di seguito per un elenco dei parametri.
5. Modificare il file wtfntusr.rsp per selezionare i font da installare.
6. Eseguire il file wtfnt.cmd
7. Riavviare il sistema.

Nota: Se CLIFI richiede di "inserire lo strumento", è necessario impostare il parametro /s: correttamente nel file wtfnt.cmd oppure posizionare il file PACKAGE.CTL nella stessa directory come pacchetti font da installare.

Utilizzare il seguente elenco di variabili come riferimento nell'impostazione delle variabili nei file indicati precedentemente.

dove:

/s: | Indica l'origine dei pacchetti font ed il file PACKAGE.CTL.
/b: | Indica l'unità di avvio.
/r2: | Indica l'unità, il percorso e il nome del file di risposte utente.
/r: | Indica il file FI (Feature Install) (wtfntusr.rsp).
/l1 e /l2 | Indicano le ubicazioni complete dei file di registrazione facoltativi. In caso di errori durante l'installazione, consultare questi file, oltre al file \os2\install\wpinstal.log nell'unità di avvio.

#### 4.1.2 Metodo tavolozza font

Per installare un font aggiuntivo utilizzando la Tavolozza font, seguire questa procedura:

1. Aprire la cartella Sistema OS/2.
2. Fare clic sulla cartella di impostazione del sistema.
3. Fare clic su Tavolozza font.
4. Fare clic sul pulsante Modifica font.
5. Fare clic sul pulsante Aggiungi.
6. Immettere l'unità e la directory in cui sono stati scaricati i file dei font.
7. Selezionare il font da installare e fare clic su Aggiungi.

## 5.0 DOUBLE-BYTE CHARACTER SET (DBCS) - INFORMAZIONI

Le sezioni seguenti forniscono informazioni relative alle lingue DBCS (double-byte character set).

### 5.1 Testo del pannello di installazione mancante o troppo lungo nei paesi DBCS

Quando si installa il Developer Kit sulle versioni DBCS di OS/2, i caratteri DBCS potrebbero non essere visualizzati sui pannelli di installazione o le righe potrebbero andare oltre il bordo destro della finestra di visualizzazione, anche con la finestra ingrandita a schermo intero.

Per risolvere questi problemi, uscire dal programma di installazione, aprire Netscape Navigator o Netscape Communicator per l'oggetto OS/2 e fare clic sulla voce di menu Opzioni. Aprire il pannello Preferenze generali e selezionare la scheda Font. Scegliere la codifica adatta al proprio paese e impostare i font proporzionali e fissi su MINCHO. Per salvare le modifiche fare clic su OK. Riavviando l'installazione del Developer Kit, il testo viene visualizzato correttamente.

### 5.2 Font TrueType installati sui sistemi in cinese

Sui sistemi in cinese tradizionale o semplificato, assicurarsi che siano installati tutti i font OS/2 TrueType disponibili. Per installare questi font, seguire le seguenti fasi:

1. In una richiesta di comandi OS/2 e dove C: è l'unità di avvio, avviare il programma di installazione selettiva immettendo il seguente comando:

            C:\OS2\INSTALL\INSTALL

   Sarà visualizzato un pannello denominato "Configurazione del sistema".
2. Andare al pannello Configurazione ed installazione di OS/2 facendo clic sul pulsante Successivo (in OS/2 Warp 4.0) o sul pulsante OK (in OS/2 Warp Server per e-business).
3. Nel pannello Configurazione ed installazione di OS/2, selezionare la casella di spunta Font TrueType.
4. Fare clic sul pulsante Altro a destra della casella di spunta.
5. Assicurarsi che tutte le caselle di spunta dei font siano selezionate. Fare clic su OK.
6. Inserire il CD-ROM del sistema operativo (OS/2 Warp Server 4.0 o OS/2 Warp Server per e-business) nell'unità CD.
7. Fare clic su OK nel pannello Directory originaria.

I font appropriati dovrebbero essere installati. Riavviare il sistema quando l'installazione dei caratteri è stata completata.

### 5.3 Program temporary Fix e FixPak per sistemi DBCS

È possibile che gli utenti DBCS rilevino i seguenti comportamenti relativi alle operazioni con il metodo d'immissione asiatico. Molti di questi elementi si riferiscono agli ultimi rilasci del sistema operativo. Tuttavia, se non è possibile eseguire l'aggiornamento all'ultimo rilascio, contattare il rappresentante locale IBM sulla disponibilità delle PTF (Program Temporary Fix) o FixPak applicabili.

La seguente tabella descrive i comportamenti relativi alle operazioni con il metodo d'immissione asiatico e i sistemi DBCS interessati.

Descrizione | Sistema DBCS interessato
--- | ---
Quando il cursore è spostato in un altro frame, rimane bloccato in IME. | Cinese tradizionale
Quando il cursore viene spostato su un altro frame della finestra di ricerca visualizzata, le operazioni di conversione non funzionano correttamente. | Cinese tradizionale
Quando il cursore viene spostato su un altro frame della finestra di ricerca visualizzata, quest'ultima non scompare dallo schermo. | Giapponese
La corretta modalità di immissione non è visualizzata dall'indicatore di modalità di immissione. | Giapponese, cinese semplificato, cinese tradizionale
Una stringa di conversione di un client attivo non scompare premendo il tasto ESC. | Cinese tradizionale
Quando l'utente passa all'IME nativo di Java, un tasto di conversione non funziona in maniera corretta. | Giapponese, cinese semplificato, cinese tradizionale
Quando si aprono troppi frame IM, il sistema viene disattivato. | Cinese tradizionale
Non è possibile continuare l'immissione se si ritorna alla modalità di immissione inglese senza selezionare alcun carattere DBCS dalla finestra di ricerca. | Cinese semplificato, cinese tradizionale
Una stringa di conversione di un client attivo non scompare premendo il tasto Ctrl+Barra spaziatrice. | Cinese semplificato
Se si preme il tasto Backspace durante la visualizzazione della finestra di ricerca si verifica una trap in IME. | Cinese semplificato
Descrizione del comportamento relativo alle operazioni con il metodo d'immissione asiatico e sistemi DBCS interessati.

### 5.4 Controllo della visualizzazione dei caratteri numerici arabi

Gli utenti di alcuni paesi potrebbero visualizzare inaspettatamente dei caratteri numerici arabi. Nelle versioni OS/2 specifiche di alcuni paesi esiste una corrispondenza tra i caratteri da x'00B0' a x'00B9' e i numeri arabi da zero (0) a nove (9). Per visualizzare i caratteri desiderati, modificare gli attributi bidirezionali nel file CONFIG.SYS oppure utilizzare la pagina Lingua del pannello Proprietà (pannello Impostazioni in OS/2 Warp Server per e-business) per ottenere l'effetto desiderato.

### 5.5 Impostazioni dell'ambiente giapponese nella versione giapponese di OS/2 Warp 4

Utilizzare le impostazioni relative all'ambiente giapponese per la versione giapponese di OS/2 Warp 4:

Codepage: | 932
ShiftJIS code: | New JIS

### 5.6 Font necessari per la versione giapponese di OS/2 Warp

Per l'esecuzione del Developer Kit, nel sistema sono richiesti i font di seguito riportati:

Nome | Stile
GOTHIC | Normal
GOTHIC | HeiseiKakuGothic-W5-H-90-TT
MINCHO | HeiseiMincho-W3-H-90-TT
Font richiesti per OS/2 Warp versione giapponese.

È possibile verificare tali font nella Font Palette, ubicata nella cartella Configurazione del sistema della cartella Sistema OS/2.

- Il font GOTHIC Normal è compreso nel font giapponese del sistema GOTHIC.
- GOTHIC HeiseiKakuGothic-W5-H-90-TT è il font TrueType IBM HeiseiKakuGothic con il nuovo ordine JIS.
- MINCHO HeiseiMincho-W3-H-90-TT è il font TrueType IBM HeiseiMincho con il nuovo ordine JIS.

Questi font possono essere installati mediante il programma di installazione selettiva, presente nella cartella Installa/Disinstalla della cartella di configurazione del sistema nei sistemi OS/2 Warp 4 e OS/2 Warp Server per e-business.

### 5.7 Miglioramento della qualità dei font in OS/2 Warp Server per e-business

In OS/2 Warp Server per e-business, è possibile migliorare la qualità dei font di minima dimensione, abilitando un'associazione tra un font outline ed un font bitmap. Per abilitare tale associazione, seguire le fasi riportate di seguito:

1. Aprire la cartella Sistema OS/2.
2. Aprire la cartella Configurazione del sistema.
3. Aprire l'oggetto Sistema.
4. Aprire la pagina Associa ai font bitmap.
5. Selezionare il pulsante Abilita.
6. Fare doppio clic sull'icona relativa al menu del sistema per chiudere l'oggetto Sistema.

Per ulteriori informazioni relative all'associazione dei font bitmap, fare clic sul pulsante Aiuto della pagina Associa ai font bitmap.

## 6.0 DISINSTALLAZIONE DEL DEVELOPER KIT

Le seguenti sezioni forniscono le informazioni sulla disinstallazione del Developer Kit.

Se sono stati installati i componenti del Developer Kit più volte, senza effettuare la disinstallazione di questi componenti, i riferimenti a JAVA131 sono contenuti nel file CONFIG.SYS. Se si desidera eliminare questi riferimenti, eliminarli dal file CONFIG.SYS.

Nota: Se Netscape Communicator è in esecuzione durante la disinstallazione del Developer Kit, la disinstallazione avrà esito negativo. È necessario chiudere Netscape Communicator e iniziare il processo di disinstallazione.

### 6.1 Metodo desktop

Per disinstallare utilizzando l'oggetto Elimina Developer Kit, seguire tale procedura:

1. Aprire la cartella Sistema OS/2.
2. Aprire la cartella Configurazione del sistema.
3. Aprire la cartella Disinstalla funzioni. Se si effettua la disinstallazione in OS/2 Warp 4, aprire le cartelle Installa/Disinstalla e Disinstalla funzioni.
4. Fare doppio clic sull'oggetto Elimina Developer Kit per OS/2 per avviare il programma di disinstallazione.

Se vengono estratti file di font aggiuntivi o i file di Java Plug-in, ad esempio il file plugin.exe o mzplugin.exe e si desidera eliminarli dal sistema, passare all'unità e alla directory in cui vengono installati ed eliminarli.

### 6.2 Metodo richiesta comandi OS/2

Per avviare la disinstallazione, verificare che sia disponibile l'unità di avvio su cui viene installato Runtime Environment. Nella richiesta comandi OS/2, immettere:

         JAVA131/UNINSTAL/UNINSTAL

Il programma di disinstallazione guida l'utente attraverso il processo di disinstallazione. Solo i file e le directory creati dal processo di installazione sono eliminati. Ad esempio, la directory HOTJAVA creata durante l'esecuzione del Programma di visualizzazione applet non viene eliminata durante la disinstallazione.

Se vengono estratti file di font aggiuntivi o i file di Java Plug-in, ad esempio il file plugin.exe o mzplugin.exe e si desidera eliminarli dal sistema, passare all'unità e alla directory in cui vengono installati ed eliminarli.

### 6.3 Disinstallazione del Developer Kit da WorkSpace On-Demand 2.0

Il supporto per la disinstallazione del Developer Kit richiede l'accesso ad un oggetto inventory (Java 1.3) nella directory delle funzioni installate (\os2\install\installed features). Se si installa il Developer Kit per il client WorkSpace On-Demand 2.0 ed il server WorkSpace On-Demand 2.0, l'oggetto inventory di Java 1.3 viene danneggiato o sostituito. Quindi, non utilizzare il programma di disinstallazione per eliminare i componenti del Developer Kit dallo spazio del client.

Eliminare la struttura della directory [rpldrive]\ibmlan\rpl\bb20.xx\JAVA131 e i riferimenti creati in questa directory, che sono stati aggiunti alle directory di immagine del client WorkSpace On-Demand. Ad esempio, i file CONFIG.SYS, OS2.INI e FIT.

Per eliminare il Developer Kit dal server, eliminare la struttura della directory \JAVA131. È possibile eliminare la struttura della directory dalla cartella Unità nella cartella Sistema OS/2.

### 6.4 Esecuzione di una disinstallazione non presidiata

Per disinstallare il Developer Kit, immettere il seguente comando su un'unica riga nella richiesta comandi OS/2:

         clifi /a:u /f:"<WP_INSTALLED>" /o:INV_JAVA13 /set:Selection=ALL

### 6.5 Eliminazione del Developer Kit come JVM predefinita

Per eliminare o sostituire il Developer Kit come JVM predefinita, eliminare l'istruzione x:\JAVA131\JRE\BIN; dall'istruzione PATH nel file CONFIG.SYS. Per rendere effettive le modifiche, riavviare il sistema.

## 7.0 LIMITAZIONI NOTE

- Se si installa il Developer Kit come JVM predefinita, esistono applicazioni note che avranno esito negativo. Tali applicazioni sono:
  - LVMGUI: L'interfaccia utente grafica per LVM (Logical Volume Manager)
  - Alcuni componenti di TCP/IP

- Il Developer Kit non è in grado di scrivere o leggere un file che è di 2 GB o superiore.

- Se si scaricano e si installano le estensioni di sicurezza Java Cryptography Extensions (JCE), cancellare il file jar di Java Cryptography Archictecture (jre/lib/ext/ibmjca.jar) durante il processo di installazione. Poiché la funzionalità JCA è un componente di JCE, Developer potrebbe non funzionare correttamente se sono installati entrambi.

- Il ponte JDBC-ODBC (Java Database Connectivity-Open Database Connectivity) non è supportato.

- Java Plug-in in questo rilascio non supporta la funzione di stampa del Developer Kit.

- Alcune applicazioni possono essere codificate in modo da ricercare gli eseguibili del Developer Kit nella directory JAVA131\bin. Tali eseguibili sono contenuti nella directory x:\JAVA131\jre\bin\. Se si utilizza un'applicazione di questo tipo, digitare quanto segue in una richiesta comandi per copiare gli eseguibili nella directory JAVA131\bin:

           copy x:\JAVA131\jre\bin\*.exe to x:\JAVA131\bin

  dove x è l'unità in cui è stato installato il Developer Kit. Per impostazione predefinita, JAVA131 è il nome della directory.

  Se al Developer Kit viene applicato un livello di servizio, ripetere il passo sopra riportato una volta applicato tale livello.

- Quando si usa IBM Java Plug-in, consentire alle applet di terminare il caricamento per evitare che il browser si blocchi. Ad esempio, se si seleziona il tasto Indietro e poi Avanti durante il caricamento di un'applet, potrebbe non essere possibile caricare le pagine HTML.

- Sebbene IBM Java Plug-in supporti lo stesso livello di LiveConnect, come riscontrato nella versione Sun corrente di Java Plug-in (1.3.0_01), alcuni malfunzionamenti di Live Connect sono stati identificati con entrambi i plug-in. Quando si riporta un malfunzionamento relativo a LiveConnect, indicare se si è verificato nella versione Sun o IBM del plug-in.

- La dimensione massima della cache del disco HPFS è di due megabyte. La dimensione massima può limitare le prestazioni del Developer Kit. In molti ambienti, il tempo di caricamento dell'applicazione e le prestazioni del sistema possono essere migliorati utilizzando una cache di dimensioni maggiori. Eventuali sistemi di file OS/2 alternativi che supportano una cache più ampia sono:

  - JFS compreso in IBM OS/2 Warp Server per e-business
  - HPFS 386 compreso in IBM OS/2 Warp Server Advanced
- Se si verificano problemi su una macchina Pentium(R) MMX o inferiore, impostare la variabile di ambiente, JAVA_COMPILER=NONE.

## 8.0 INFORMAZIONI PARTICOLARI

(c) Copyright International Business Machines Corporation 1999, 2002. Tutti i diritti riservati.

Limitazioni per gli utenti degli Stati Uniti d'America. L'utilizzo, la duplicazione o la divulgazione sono limitati dal supplemento GSA ADP al contratto con l'IBM Corporation.

Consultare il rappresentante commerciale IBM per informazioni relative ai prodotti e servizi disponibili nel proprio paese. Qualunque riferimento relativo a prodotti, programmi o servizi IBM non implica che l'IBM intenda renderli disponibili in tutti i paesi in cui opera. In sostituzione a quelli forniti dall'IBM, possono essere usati prodotti, programmi o servizi funzionalmente equivalenti che non comportino violazione dei diritti di proprietà intellettuale. È responsabilità dell'utente valutare e verificare la possibilità di utilizzare altri programmi e/o prodotti, fatta eccezione per quelli espressamente indicati dall'IBM.

L'IBM può avere brevetti o domande di brevetto in corso relativi a quanto trattato nella presente pubblicazione. La fornitura di questa pubblicazione non implica la concessione di alcuna licenza su di essi. Chi desiderasse ricevere informazioni relative a licenze può rivolgersi per iscritto a:

Director of Commercial Relations
IBM Europe
Schoenaicher Str. 220
D-7030 Boeblingen
Deutchland

Chi desiderasse ricevere delucidazioni sulle licenze relative alle informazioni DBCS, può contattare IBM Intellectual Property Department nel proprio paese o rivolgersi per iscritto a:

IBM World Trade Asia Corporation Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106-0032, Japan

Il seguente paragrafo non è valido per il regno Unito o per tutti i paesi in cui le leggi nazionali siano in contrasto con le disposizioni in esso contenute:

L'IBM FORNISCE QUESTA PUBBLICAZIONE SENZA ALCUNA GARANZIA, ESPLICITA O IMPLICITA, IVI INCLUSE EVENTUALI GARANZIE DI COMMERCIABILITÀ ED IDONEITÀ AD UNO SCOPO PARTICOLARE.

Alcune nazioni non escludono le garanzie implicite; di conseguenza la suddetta esclusione potrebbe, in questo caso, non essere applicabile.

Queste informazioni potrebbero contenere imprecisioni tecniche o errori tipografici. Le correzioni relative saranno incluse nelle nuove edizioni. L'IBM si riserva il diritto di apportare miglioramenti o modifiche al prodotto o al programma descritto in qualsiasi momento e senza preavviso.

Tutti i riferimenti a pubblicazioni e a siti Web non dell'IBM contenuti in questo documento sono forniti solo per consultazione. I materiali contenuti in tali pubblicazioni e siti Web non fanno parte di questo prodotto e l'utilizzo di questi è a discrezione dell'utente.

L'IBM può utilizzare o distribuire qualsiasi informazione voi forniate nel modo più appropriato senza incorrere in alcuna obbligazione nei vostri riguardi.

Coloro che detengono la licenza su questo programma e desiderano avere informazioni su di esso allo scopo di consentire: (i) uno scambio di informazioni tra programmi indipendenti ed altri (compreso questo) e (ii) l'uso reciproco di tali informazioni, dovrebbero rivolgersi a:

JTCMAIL@uk.ibm.com
[Hursley Java Technology Center (JTC) contact]

Queste informazioni possono essere rese disponibili secondo condizioni contrattuali appropriate, compreso, in alcuni casi, l'addebito di un canone.

Il programma su licenza descritto in queste informazioni e tutto il materiale su licenza ad esso relativo sono forniti dall'IBM nel rispetto delle condizioni previste dalla licenza d'uso.

I dati relativi alle prestazioni contenuti nel presente documento sono stati ottenuti in un ambiente controllato. Pertanto, i risultati ottenibili in altri ambienti operativi potrebbero variare significativamente. Alcune rilevazioni sono state effettuate su sistemi in fase di sviluppo e non si garantisce in alcun modo che tali rilevazioni siano uguali su tutti i sistemi. Inoltre, alcune rilevazioni non state effettuate tramite estrapolazione. Pertanto, i risultati effettivi possono essere differenti. Gli utenti devono verificare l'applicabilità dei dati negli specifici ambienti operativi.

Le informazioni relative a prodotti non IBM sono state ottenute dai fornitori di tali prodotti. L'IBM non ha verificato tali prodotti e, pertanto, non può garantirne l'accuratezza delle prestazioni. Eventuali commenti relativi alle prestazioni dei prodotti non IBM devono essere indirizzati ai fornitori di tali prodotti.

Tutte le dichiarazioni riguardanti la futura direzione o le intenzioni della IBM sono soggette a sostituzione o al ritiro senza preavviso, e rappresentano unicamente scopi e obiettivi della IBM stessa.

LICENZE SUL COPYRIGHT:

Questo documento contiene esempi di programmi applicativi nella lingua sorgente che illustrano le tecniche di programmazione nelle varie piattaforme operative. Questi esempi possono essere copiati, modificati e distribuiti in qualsiasi forma senza alcun pagamento alla IBM, allo scopo di sviluppare, utilizzare, commercializzare o distribuire i programmi applicativi in modo conforme alle API (Application Programming Interface) a seconda della piattaforma operativa per cui gli esempi dei programmi sono stati scritti.

Per questi esempi non è stata eseguita una verifica esaustiva e in tutte le possibili condizioni. La IBM, pertanto, non garantisce né intende fornire tali programmi come affidabili e funzionalmente corretti. È possibile copiare, modificare e distribuire questi esempi di programmi sotto qualsiasi forma senza alcun pagamento alla IBM, allo scopo di sviluppare, utilizzare, commercializzare o distribuire i programmi applicativi in modo conforme alle API (Application Programming Interface) IBM.

Questa edizione si riferisce alla Versione 1.3.1 di IBM OS/2 Warp Developer Kit, Java(TM) Technology Edition e a tutte le modifiche e rilasci successivi se non diversamente indicato nelle nuove edizioni.

Questo software è basato in parte sul lavoro del Free Type Project. Per ulteriori informazioni circa il Free Type Project, consultare il sito: http://www.freetype.org

## 9.0 MARCHI

Quelli di seguito riportati sono marchi della International Business Machines Corporation:

IBM
OS/2
OS/2 Warp
NetView
WebExplorer

Java e tutti i marchi e i logo su base Java sono marchi o marchi registrati della Sun Microsystems, Inc..

Microsoft e Windows NT sono marchi della Microsoft Corporation.

Intel e Pentium sono marchi della Intel Corporation.

I nomi di altre società, prodotti e servizi potrebbero essere marchi di altre società.

[FINE DELLA GUIDA ALL'INSTALLAZIONE E ALLA CONFIGURAZIONE]