### IBM(R) OS/2 WARP(R) DEVELOPER KIT
JAVA(TM) 2 TECHNOLOGY EDITION, 1.3.1
INSTALLATION UND KONFIGURATION

(c) Copyright IBM Corporation 1999, 2002. All rights reserved.
(c) Copyright IBM Deutschland GmbH 1999, 2002. Alle Rechte vorbehalten.

Hinweis: Die vollständigen Copyright-Angaben finden Sie im Abschnitt Bemerkungen dieses Dokuments.

Informationen, die nur für bestimmte Länder Gültigkeit haben und für Deutschland, Österreich und die Schweiz nicht zutreffen, wurden in dieser Veröffentlichung im englischen Originaltext übernommen.

Dieses Handbuch enthält Informationen zu IBM OS/2 Warp Developer Kit, Java(TM) 2 Technology Edition, Version 1.3.1 (Developer Kit). In diesem Handbuch erhalten Sie Informationen zur Vorbereitung und Durchführung der Installation der Komponenten von Developer Kit sowie zu Punkten, die nach der Installation beachtet werden müssen.

Developer Kit wird von folgenden OS/2(R)-Produkten unterstützt:

- OS/2 Warp 4 ab FixPak 5 für Länder und Regionen mit Einzelbytezeichensatz (SBCS)
  oder FixPak FX00505 für Länder und Regionen mit Doppelbytezeichensatz (DBCS)
- OS/2 Warp Server for 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 Version 2.0 mit dem neuesten FixPak

Hinweis: Informationen zu erforderlichen FixPaks und der IBM Website mit FixPaks finden Sie im Abschnitt FixPaks.

Geben Sie den folgenden Befehl in einer Befehlszeile ein, um die IBM Build-Nummer und die Versionsnummer von Developer Kit abzurufen:

           java -version

### Inhalt

- 1.0 VOR DER INSTALLATION
- 1.1 Installationsvoraussetzungen
- 1.2 Entpacken der Dateien für die Installation
- 1.3 Überlegungen zu Dateisystempartitionen
- 1.4 FixPaks
- 1.5 Installieren von Developer Kit als Standard-JVM

- 1.5.1 Informationen zur Umgebungsvariablen JAVA_HOME

- 1.6 Informationen zu Netscape Communicator
- 1.7 Verknüpfen von Teildateien
- 2.0 INSTALLIEREN VON DEVELOPER KIT
- 2.1 GUI-Installation

- 2.1.1 Über den Desktop
- 2.1.2 Über eine Eingabeaufforderung
- 2.1.3 Während der Installation nicht auswählbare Komponenten
- 2.1.4 Wiederherstellen nach einer fehlgeschlagenen Installation
- 2.1.5 Installationsfehler trotz korrekter FixPak-Stufe

- 2.2 Nicht überwachte Installation (CID)
  - 2.2.1 Ändern der CID-Antwortdatei
  - 2.2.1.1 Installationslaufwerke der Komponenten
  - 2.2.2 Starten der nicht überwachten Installation
  - 2.2.3 Rückkehrcode über erfolgreiche Installation bei fehlgeschlagener CID-Installation
  - 2.2.4 Installationsfehler trotz korrekter FixPak-Stufe
- 2.3 Installationsvoraussetzungen für NVDM/2

- 2.3.1 Statischer Befehl im NVDM/2-Profil

- 2.4 Installieren von Developer Kit unter WorkSpace On-Demand 2.0

- 2.4.1 Installieren von Developer Kit auf einem WorkSpace On-Demand 2.0-Server
- 2.4.2 Installieren von Developer Kit auf einem WorkSpace On-Demand 2.0-Client

- 2.4.2.1 Nicht überwachte Installation für einen WorkSpace On-Demand 2.0-Client
- 2.4.2.2 Ändern der CONFIG.SYS-Dateien für WorkSpace On-Demand 2.0-Clients
- 2.4.2.3 Ändern von FIT-Dateien und Erteilen von Zugriff auf WorkSpace On-Demand 2.0-Clients
- 2.4.2.4 Zuordnen des Verzeichnisses USER_HOME für WorkSpace On-Demand 2.0-Clients
- 2.4.2.5 Aktivieren von Schriftarten für WorkSpace On-Demand 2.0-Clients
- 2.4.2.6 Installieren des Netscape Communicator-Plug-Ins für WorkSpace On-Demand 2.0-Clients
- 2.4.2.7 Installieren weiterer Komponenten von Developer Kit auf dem WorkSpace On-Demand 2.0-Client
- 2.4.2.8 Ausführen von Java-Beispielen von einem WorkSpace On-Demand 2.0-Client aus
- 2.4.2.9 Definieren einer sicheren Verbindung zu einem WorkSpace On-Demand 2.0-Client
- 2.4.2.10 Der JIT-Compiler und ein WorkSpace On-Demand 2.0-Client
- 2.4.2.11 Erstellen einer allgemeinen Anwendung der Java-Plug-In-Steuerkonsole für den WorkSpace On-Demand 2.0-Client

- 2.5 RIPL-Installation

- 2.5.1 Erstellen von Antwortdateien
- 2.5.2 Ändern der Datei JAVA131.RSP
- 2.5.3 Aktualisieren von Dateien für Feature Install
- 2.5.4 Starten der RIPL-Installation
- 2.5.5 Ausführen von Java-Beispielen von einem RIPL-Client aus

- 2.5.5.1 Definieren einer sicheren Verbindung auf einem RIPL-Client

- 3.0 NACH DER INSTALLATION
- 3.1 Weitere Informationsquellen
- 3.2 Installieren weiterer Komponenten
- 3.3 Überlegungen zu den AWT-Steuerelementen "TextField" und "TextArea"
- 3.4 Änderung der Datei mit Schriftarteinstellungen wird nicht unterstützt
- 3.5 Probleme mit der Zeiteinstellung in Java-Applets
- 3.6 Verwenden der OS/2-High Memory-Unterstützung zum Erhöhen der Java-Freispeichergröße

- 3.6.1 Aktivieren der OS/2-High Memory-Unterstützung
- 3.6.2 Aktivieren des Java-Freispeichers für die Verwendung der OS/2-High Memory-Unterstützung
- 3.6.3 Einschränkungen bei der Verwendung der OS/2-High Memory-Unterstützung

- 3.7 Die erweiterte Klasse BigDecimal
- 3.8 Die Java-Plug-Ins
  - 3.8.1 Installieren des Java-Plug-Ins nach der Installation von Netscape Communicator
  - 3.8.2 Installieren des Java-Plug-Ins nach der Installation von IBM Web Browser for OS/2
  - 3.8.3 Die Java Plug-In-Steuerkonsole
- 3.9 Inaktivieren des JIT-Compilers
- 3.10 Ändern von Dateinamen
- 3.11 Konfigurieren der Applet-Ansicht
- 3.12 Angeben der Optionen und der Systemmerkmale für Java
- 3.13 RMI über IIOP

- 3.13.1 Der Compiler von IDL nach Java

- 3.13.1.1 Einschränkungen des Compilers von IDL nach Java
- 3.13.1.2 Bekannte Probleme des Compilers von IDL nach Java

- 3.13.2 Weitere Informationen
- 3.13.3 RMI-IIOP-Begriffe

- 3.14 Java Authentication and Authorization Service (JAAS)

- 3.14.1 Unterschied zwischen der IBM und der Sun-Version von JAAS
- 3.14.2 Basisinstallation

- 3.15 JNI-Programmierinformationen
- 3.16 Überlegungen zur Systemleistung
- 4.0 WEITERE SCHRIFTARTPAKETE
- 4.1 Installieren weiterer Schriftarten

- 4.1.1 CID-Installation
- 4.1.2 Über die Schriftartpalette

- 5.0 DOUBLE-BYTE CHARACTER SET (DBCS) INFORMATION
- 5.1 Installation panel text missing or too long in DBCS countries or regions
- 5.2 TrueType fonts must be installed on Chinese systems
- 5.3 Program temporary fixes and FixPaks for DBCS systems
- 5.4 Controlling Arabic number character display
- 5.5 Japanese environment settings on OS/2 Warp 4 Japanese version
- 5.6 Required fonts on OS/2 Warp Japanese version
- 5.7 Improving font quality on OS/2 Warp Server for e-business
- 6.0 DEINSTALLIEREN VON DEVELOPER KIT
- 6.1 Über den Desktop
- 6.2 Über eine OS/2-Eingabeaufforderung
- 6.3 Deinstallieren von Developer Kit unter WorkSpace On-Demand 2.0
- 6.4 Nicht überwachtes Deinstallieren
- 6.5 Entfernen von Developer Kit als Standard-JVM
- 7.0 BEKANNTE EINSCHRÄNKUNGEN
- 8.0 BEMERKUNGEN
- 9.0 ÄNDERUNGEN IN DER IBM TERMINOLOGIE
- 10.0 MARKEN

## 1.0 VOR DER INSTALLATION

Developer Kit enthält zwei Pakete: Runtime Environment und Toolkit. Runtime Environment beinhaltet Komponenten wie Java Authentication and Authorization Service (JAAS), RMI-IIOP, Runtime und den JIT-Compiler (JIT - Just-in-Time). Toolkit enthält Komponenten wie ein Toolkit, den ICAT-Debugger (ICAT - Interactive Code Analysis Tool) und Beispiele (Samples).

Hinweis: Sie können Toolkit nur installieren, wenn Sie auch Runtime Environment installieren.

Wenn Sie Teildateien heruntergeladen haben, finden Sie im Abschnitt Verknüpfen von Teildateien Informationen zum Verknüpfen der Teildateien in eine installierbare Datei.

Sichern Sie Ihre aktuelle Datei CONFIG.SYS, bevor Sie Developer Kit installieren. Dadurch wird sichergestellt, dass Sie zu Ihrer ursprünglichen Umgebung zurückkehren können, wenn während der Installation ein Problem auftreten sollte.

In diesem Handbuch werden die folgenden Begriffe wie folgt verwendet:

- OS/2 Warp 4 bezieht sich auf das OS/2 Warp 4-Client-Betriebssystem und auf den WorkSpace On-Demand-Client (2.0 oder 3.0).
- OS/2 Warp Server bezieht sich auf die OS/2 Warp Server for e-business-Betriebssysteme und auf den WorkSpace On-Demand-Server (2.0 oder 3.0).
- Java 1.1.x bezieht sich auf Java 1.1.1 für OS/2, Java 1.1.4 für OS/2 Warp, IBM OS/2 Warp Developer Kit, Java(TM) Edition, Version 1.1.6, IBM OS/2 Warp Developer Kit, Java Edition, Version 1.1.7, und IBM OS/2 Warp Developer Kit, Java Edition, 1.1.8.
- Für dieses Produkt spezifische Objekte werden als Java 1.3.1.-Objekte bezeichnet.
- Netscape Communicator bezieht sich auf Netscape Communicator 4.04 und höher, sofern nicht direkt angegeben.

### 1.1 Installationsvoraussetzungen

Erforderlicher Plattenspeicherplatz:

Nachstehend finden Sie eine Liste der Komponenten von Developer Kit und der Dateigrößen nach der Installation. Stellen Sie vor der Installation sicher, dass ausreichend Plattenspeicherplatz vorhanden ist.

Komponente | Größe
--- | ---
Runtime Environment | 25,0 MB
Toolkit | 35,0 MB
Beispiele (Samples) | 5,0 MB
ICAT Debugger für OS/2 Java | 13,0 MB
Gesamtinstallation | 65,0 MB
Liste der Komponenten von Developer Kit mit der Dateigröße nach der Installation

Hardwarevoraussetzungen:

- Ein Minimum von 32 MB Arbeitsspeicher (RAM) wird im Allgemeinen zur Ausführung von Developer Kit-Anwendungen empfohlen.
- Ein Minimum von 48 MB Arbeitsspeicher wird für Applets, die in einem Browser mit der Java-Plug-In-Komponente ausgeführt werden, empfohlen.
- IBM empfiehlt die Verwendung eines Intel(R) Pentium(R) (oder vergleichbaren) oder neueren Prozessors für alle OS/2-Systeme.
- Die Spezifikation von Developer Kit erfordert den 256-Farbenmodus (oder besser). Developer Kit unterstützt weder Java-Anwendungen noch Java-Applets, die mit dem Abstract Window Toolkit (AWT) im 16-Farbenmodus ausgeführt werden.

Softwarevoraussetzungen:

- Feature Install 1.2.3 oder höher. Sie können die neueste Version von Feature Install von der IBM Software Choice-Homepage herunterladen. Überprüfen Sie vor dem Herunterladen von Feature Install die Installationsvoraussetzungen für Feature Install.
- Netscape Communicator 4.0.4. oder höher.
- TCP/IP Version 4.3 für OS/2 oder höher. Sie können dieses Produkt von der IBM Software Choice-Homepage herunterladen.

### 1.2 Entpacken der Dateien für die Installation

Gehen Sie wie folgt vor, um eine sich selbst entpackende ZIP-Datei zu entpacken:

1. Erstellen Sie ein Unterverzeichnis (falls nicht bereits vorhanden) zum Speichern der sich selbst entpackenden ZIP-Datei auf Ihrem Festplattenlaufwerk.
2. Führen Sie die Datei aus, indem Sie an einer Eingabeaufforderung in dem Verzeichnis, in das Sie die Datei heruntergeladen haben, den Namen der Datei und den Parameter "-o" eingeben.

   Geben Sie für Developer Kit beispielsweise Folgendes ein:

       javaintk.exe -o

   Geben Sie Folgendes für Runtime Environment ein:

       javainrt.exe -o

Wenn Sie Teildateien heruntergeladen haben und diese in eine installierbare Datei verknüpfen müssen, lesen Sie den Abschnitt Verknüpfen von Teildateien. Informationen zum Installieren von Developer Kit finden Sie im Abschnitt Installieren von Developer Kit.

### 1.3 Überlegungen zu Dateisystempartitionen

Berücksichtigen Sie bei der Installation von Developer Kit folgende Überlegungen:

- Wenn Sie Toolkit installieren, wird Runtime Environment automatisch ausgewählt und auf demselben Laufwerk wie Toolkit installiert.
- Toolkit und Beispieldateien müssen auf einer HPFS-Partition (HPFS - High Performance File System) oder JFS-Partition (JFS - Journaled File System) installiert werden.
- Runtime Environment und ICAT Debugger können auf einer FAT-Partition (FAT - File Allocation Table) installiert werden.
- Wenn Sie Toolkit nicht installieren, kann Runtime Environment auf einer FAT-, HPFS- oder JFS-Partition installiert werden. Es empfiehlt sich jedoch, diese Komponenten auf einer HPFS-Partition oder JFS-Partition zu installieren, da diese lange Dateinamen unterstützen.

Wenn Sie nur eine Festplatte mit einer einzigen FAT-Partition haben, haben Sie drei Möglichkeiten:

- Lassen Sie Ihr System, wie es ist, und installieren Sie nur die Runtime-Komponente und bei Bedarf ICAT Debugger.
- Formatieren Sie die FAT-Partition für HPFS oder JFS, und installieren Sie die gesamte Software neu.
- Erwerben Sie ein Plattenpartitionierungsprogramm, z. B. PartitionMagic. Bei ausreichendem Speicherplatz verringert ein Plattenpartitionierungsprogramm die Größe der aktuellen Partition (Laufwerk C) und erstellt eine neue Partition (logisches Laufwerk D), die für HPFS formatiert werden kann.

Hinweis: In diesem Dokument bezieht sich der Ausdruck "Partition" auf ein physisches oder logisches Laufwerk.

### 1.4 FixPaks

Es gelten folgende Voraussetzungen:

Erforderliche System-FixPak-Stufe für OS/2 Warp 4
SBCS | DBCS
FixPak 5 oder höher | FixPak FX00505
Überlegungen zu FixPak-Stufen

Zur Verwendung des Euro-Symbols in Java-Anwendungen und -Applets
OS/2 Warp 4 | FixPak 6 oder höher
FixPak-Stufen für die Verwendung des Euro-Symbols

Hinweis: Die Anzeige und Codeumsetzung des Euro-Symbols wird nur für die Codepages unterstützt, die dieses Symbol enthalten.

Wollen Sie das Euro-Symbol eingeben, ist die SBCS-Version von OS/2 erforderlich. Die internationale amerikanische Tastatur, UX103, unterstützt die Eingabe des Euro-Symbols, die englische Standardtastatur tut dies nicht. Wenn Ihre Tastatur die Eingabe des Euro-Symbols nicht unterstützt, gilt grundsätzlich, dass Sie dieses Symbol zwar anzeigen, jedoch nicht eingeben können.

Informationen zum Herunterladen eines bestimmten FixPaks finden Sie auf der IBM Website für FixPaks unter folgender Adresse:
http://ps.software.ibm.com/pbin-usa-ps/getobj.pl?/pdocs-usa/otherservices.html

### 1.5 Installieren von Developer Kit als Standard-JVM

Wenn Sie Developer Kit als standardmäßig verwendete virtuelle Java-Maschine (JVM) installieren, können Sie Developer Kit standardmäßig über eine Eingabeaufforderung ausführen. Sie können Developer Kit permanent oder temporär als Standard-JVM definieren. Weitere Informationen dazu finden Sie in den folgenden Abschnitten.

#### Definieren von Developer Kit als permanente Standard-JVM

Sie können Developer Kit auf eine der folgenden Arten permanent als Standard-JVM definieren:

- Wählen Sie es während der Installation der GUI aus.
- Wenn Sie Developer Kit (Version 1.3) bereits installiert haben, können Sie die Änderung manuell vornehmen, indem Sie die Anweisung PATH in der Datei CONFIG.SYS ändern.

Sie können die Anweisung PATH ändern, indem Sie die Angabe "x:\JAVA131\JRE\BIN;" der Anweisung PATH in der Datei CONFIG.SYS hinzufügen.

Wenn Sie eine frühere Java-Version weiterhin als Standard-JVM verwenden wollen, wählen Sie das Markierungsfeld während der GUI-Installation nicht aus, oder fügen Sie den Pfad "x:\JAVA131\JRE\BIN;" der Anweisung PATH in der Datei CONFIG.SYS nicht hinzu, falls Sie Developer Kit bereits installiert haben. Wenn Sie bereits eine 1.1.x-Version von Java als Standard-JVM installiert haben, bleibt diese als Standard-JVM erhalten.

Hinweis: Sie können die Leistung möglicherweise verbessern, indem Sie Verweise auf frühere Java-Releases in der Datei CONFIG.SYS entfernen. Es ist jedoch bekannt, dass manche Anwendungen nach der Installation von Developer Kit (Version 1.3.x) als Standard-JVM nicht mehr ausgeführt werden können.

#### Temporäres Verwenden von Developer Kit für eine Java-Sitzung

Wenn Developer Kit nicht als Standard-JVM installiert wurde, Sie diese aber in einer Java-Sitzung verwenden wollen, ändern Sie die Anweisung PATH. Beispiel:

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

Dabei ist x das Laufwerk, auf dem Developer Kit installiert ist.

Sie können die Leistung verbessern, indem Sie die Anweisungen BEGINLIBPATH und CLASSPATH wie folgt ändern:

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

Hinweis: CLASSPATH ist auf einen Nullwert gesetzt, da die JVM von Developer Kit CLASSPATH im Allgemeinen nicht zum Suchen von Systemklassendateien benötigt; CLASSPATH wird für Anwendungsklassendateien verwendet.

#### Temporäres Verwenden der JVM von Java 1.1.x für eine Java-Sitzung

Wenn Developer Kit 1.3.x als Standard-JVM installiert wurde, Sie aber eine Java 1.1.x-JVM in einer Java-Sitzung verwenden wollen, müssen Sie die Anweisung PATH ändern. Beispiel:

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

Dabei ist x das Laufwerk, auf dem Developer Kit 1.1.x installiert ist.

Wenn Sie die JAVA11-Verweise aus der Datei CONFIG.SYS entfernt haben, müssen Sie die Anweisungen PATH, BEGINLIBPATH und CLASSPATH wie folgt ändern:

        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;\;

Hinweis: CLASSPATH ist auf die Java 1.1.x-Bibliotheksdateien gesetzt. Die CLASSPATH-Einstellung weicht für einzelne Systeme ab.

Zum Ausführen von Developer Kit und dem Java-Plug-In müssen Sie PATH wie oben angegeben ändern.

#### 1.5.1 Informationen zur Umgebungsvariablen JAVA_HOME

Wenn Sie Developer Kit Version 1.3 als Standard-JVM (JVM - Java Virtual Machine) installiert haben, und Sie über Folgendes verfügen:

- Eine Umgebungsvariable JAVA_HOME, die der Datei CONFIG.SYS einer vorherigen Version von Developer Kit manuell hinzugefügt wurde
- Befehlsdateien, die die Umgebungsvariable JAVA_HOME setzen

Gehen Sie folgendermaßen vor:

- Entfernen oder aktualisieren Sie die Umgebungsvariable JAVA_HOME in Ihrer Datei CONFIG.SYS.
- Ändern Sie die Befehlsdateien, indem Sie die Anweisungen entfernen bzw. ändern, die die Umgebungsvariable JAVA_HOME setzen.

### 1.6 Informationen zu Netscape Communicator

In der folgenden Liste finden Sie Informationen zur Verwendung von Developer Kit und Netscape Communicator Version 4.04 und höher:

- #### Ausführen von Netscape Communicator während der Installation von Developer Kit

  Sie können Developer Kit nicht installieren, wenn Sie den Befehl INSTALL ausführen, während Netscape Communicator aktiv ist. Sie müssen zuerst Netscape Communicator schließen und dann den Befehl INSTALL ausführen.

- #### Netscape Communicator Version 4.04 und der JIT-Compiler

  Der Just-In-Time-Compiler (JIT) muss aktiv sein, um Applets mit Netscape Communicator Version 4.04 auszuführen. Wenn Sie JIT jedoch inaktivieren, aber Netscape Communicator Version 4.04 weiter verwenden wollen, müssen Sie den neuesten Aktualisierungsstand von Netscape Communicator Version 4.04 verwenden. Informationen zum neuesten Aktualisierungsstand finden Sie auf folgender Website:

  http://ps.software.ibm.com

- #### Scheinmarkierungsfelder bei der Installation und Netscape Communicator Version 4.61

  Wenn Sie mit Netscape Communicator Version 4.61 arbeiten und nicht die neueste Aktualisierung heruntergeladen haben, sehen Sie möglicherweise "Scheinmarkierungsfelder" bei der Installation. Diese Scheinmarkierungsfelder beeinträchtigen die Installation von Developer Kit zwar nicht. Dennoch empfiehlt es sich, die neueste Aktualisierung von folgender Website herunterzuladen:
  http://ps.software.ibm.com

- Wenn Sie Java Developer Kit Version 1.3 installieren und anschließend die JAVA11-Einträge aus Ihrer Datei CONFIG.SYS entfernen oder Version 1.1.x von Developer Kit von Ihrem System löschen, können Sie keine Applets ausführen, deren HTML-Seiten die Anweisung <APPLET> enthalten, wenn die Applets über einen Netscape 4.x-Browser gestartet werden. Wenn Sie diese Applets über einen Netscape 4.x-Browser ausführen möchten, müssen Sie das Java-Plug-In von Developer Kit Version 1.3 installieren und die HTML-Datei des Applets für die Verwendung des Java-Plug-Ins konvertieren. Applets, die über IBM Web Browser for OS/2 gestartet werden, können unverändert eingesetzt werden, selbst wenn die Java 1.1.x-JVM nicht auf dem System installiert ist.

### 1.7 Verknüpfen von Teildateien

Sie können die Teildateien mit dem Dienstprogramm Merge verknüpfen oder manuell über eine Eingabeaufforderung. In den folgenden Abschnitten finden Sie Informationen zum Verknüpfen der Teildateien in eine installierbare Datei.

Stellen Sie zu Beginn Folgendes sicher:

- Sie müssen alle Teildateien der zu installierenden Komponente herunterladen und den korrekten Dateinamen verwenden. Wenn Sie nicht alle Teilpakete eines Pakets heruntergeladen oder beim Herunterladen deren Namen geändert haben, zeigt das Dienstprogramm Merge eine Fehlernachricht an und das Paket wird nicht wiederhergestellt.
- Alle Dateinamen sind in der richtigen Reihenfolge angegeben. Wenn Sie beim Herunterladen die Dateinamen geändert haben, geben Sie die verwendeten Dateinamen an.
- Der Name der Datei, zu der Sie die Teildateien zusammenfügen, muss der vollständige Name des ursprünglichen Pakets sein. (Der vollständige Name von Runtime Environment beispielsweise ist javainrt.exe.) Dadurch wird sichergestellt, dass die Datei vom Installationsprogramm erkannt wird.

#### Verknüpfen der Teildateien mit dem Dienstprogramm Merge

Bevor Sie die Teildateien verknüpfen, müssen Sie das Dienstprogramm Joiner in dasselbe Verzeichnis herunterladen, in dem sich auch die heruntergeladenen Teildateien befinden. (Der Dateiname ist joiner.exe.) Im Dienstprogramm Joiner ist das Dienstprogramm Merge enthalten, mit dem Sie die Teildateien zu einer installierbaren Datei verknüpfen können. Sie können das Dienstprogramm Joiner von derselben IBM Software Choice-Homepage herunterladen wie die Komponenten von Developer Kit.

Geben Sie `joiner` an einer Eingabeaufforderung in dem Verzeichnis ein, in das Sie das Dienstprogramm Joiner heruntergeladen haben. Mit diesem Befehl wird das Dienstprogramm Merge (merge.exe) und dessen erforderliche Datendateien extrahiert. Mit dem Dienstprogramm Merge verknüpfen Sie die Teildateien.

Geben Sie `merge` an einer Eingabeaufforderung in dem Verzeichnis ein, in das Sie das Dienstprogramm Joiner heruntergeladen haben. Dadurch werden Pakete, die zuvor in mehrere Dateien aufgeteilt worden waren, wiederhergestellt. Zum Installieren der Datei lesen Sie den Abschnitt Installieren von Developer Kit.

#### Manuelles Verknüpfen der Teildateien über eine Eingabeaufforderung

1. Stellen Sie sicher, dass Sie alle Teildateien der zu installierenden Komponente in dasselbe Verzeichnis geladen haben.
2. Geben Sie an einer Eingabeaufforderung (in dem Verzeichnis, in das Sie die Teildateien geladen haben) die Namen der Teildateien und den Namen der vollständigen Datei ein. Wenn Sie beispielsweise die Teildateien von Runtime Environment verknüpfen wollen, geben Sie Folgendes ein:

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

Dadurch werden Pakete, die zuvor in mehrere Dateien aufgeteilt worden waren, wiederhergestellt. Zum Installieren der Datei lesen Sie den Abschnitt Installieren von Developer Kit.

## 2.0 INSTALLIEREN VON DEVELOPER KIT

Die folgenden Abschnitte enthalten Anweisungen und Informationen zur Installation von Developer Kit. Lesen Sie vor der Installation von Developer Kit oder der zugehörigen Komponenten den Abschnitt Vor der Installation als Information zum Entpacken der Dateien und zu den Installationsvoraussetzungen.

### 2.1 GUI-Installation

Sie können Developer Kit über den Desktop oder über eine Eingabeaufforderung installieren. Anweisungen dazu finden Sie in den folgenden Abschnitten.

#### 2.1.1 Über den Desktop

Hinweis: Wenn Netscape Communicator während der Installation von Developer Kit aktiv ist, schlägt die Installation fehl. Sie müssen Netscape Communicator schließen, bevor Sie den Installationsprozess starten.

Gehen Sie wie folgt vor, um die Installation mit Hilfe des Objekts INSTALL.EXE durchzuführen:

1. Öffnen Sie den OS/2-Ordner System.
2. Öffnen Sie das Objekt Laufwerke.
3. Öffnen Sie das Laufwerk, auf dem die Developer Kit-Dateien extrahiert wurden.
4. Öffnen Sie den Ordner, in dem die Developer Kit-Dateien extrahiert wurden.
5. Klicken Sie das Objekt INSTALL.EXE doppelt an, um das Installationsprogramm zu starten.

Der Befehl INSTALL.EXE startet eine grafische Benutzerschnittstelle (GUI) mit Knöpfen, anhand derer Sie die Sprache für das Programm auswählen können. Klicken Sie den Knopf für die gewünschte Sprache an. Das Installationsprogramm führt Sie dann durch die einzelnen Schritte der Installation.

Der Ordner Developer Kit for OS/2 wird unter OS/2 Warp 4 im Ordner Programme und für alle anderen unterstützten Plattformen auf dem Desktop erstellt.

Wenn Sie nach der Installation das Verzeichnis bereinigen möchten, in dem die Developer Kit-Dateien extrahiert wurden, können Sie das Objekt DELINST.CMD im Developer Kit-Ordner auswählen. Dadurch werden die Developer Kit-Dateien und -Unterverzeichnisse aus dem Verzeichnis gelöscht, in dem sie extrahiert wurden. Dateien und Unterverzeichnisse, die nicht aus dem Developer Kit extrahiert wurden, werden nicht gelöscht. Sie können die heruntergeladenen Dateien auch manuell löschen.

#### 2.1.2 Über eine Eingabeaufforderung

Hinweis: Wenn Netscape Communicator während der Installation von Developer Kit aktiv ist, schlägt die Installation fehl. Sie müssen Netscape Communicator schließen, bevor Sie den Installationsprozess starten.

Stellen Sie vor dem Starten der Installation sicher, dass Sie sich in dem Verzeichnis befinden, in dem die Dateien für Developer Kit extrahiert wurden. Geben Sie an einer OS/2-Eingabeaufforderung Folgendes ein:

         INSTALL

Der Befehl INSTALL startet eine grafische Benutzerschnittstelle (GUI) mit Knöpfen, anhand derer Sie die Sprache für das Programm auswählen können. Klicken Sie den Knopf für die gewünschte Sprache an. Das Installationsprogramm führt Sie dann durch die einzelnen Schritte der Installation.

Der Ordner Developer Kit for OS/2 wird unter OS/2 Warp 4 im Ordner Programme und für alle anderen unterstützten Plattformen auf dem Desktop erstellt.

Wenn Sie nach der Installation das Verzeichnis bereinigen möchten, in dem die Developer Kit-Dateien extrahiert wurden, können Sie das Objekt DELINST.CMD im Developer Kit-Ordner auswählen. Dadurch werden die Developer Kit-Dateien und -Unterverzeichnisse aus dem Verzeichnis gelöscht, in dem sie extrahiert wurden. Dateien und Unterverzeichnisse, die nicht aus dem Developer Kit extrahiert wurden, werden nicht gelöscht. Sie können die heruntergeladenen Dateien auch manuell löschen.

#### 2.1.3 Während der Installation nicht auswählbare Komponenten

Wenn Sie Developer Kit über die grafische Benutzerschnittstelle installieren und Komponenten nicht ausgewählt werden können, haben Sie möglicherweise nicht die richtige ZIP-Datei heruntergeladen und entpackt. Rufen Sie die IBM Software Choice-Homepage erneut auf und laden Sie die richtige selbstextrahierende ZIP-Datei herunter.

Für alle Komponenten von Developer Kit ist es erforderlich, die Runtime Environment-Komponente herunterzuladen und zu installieren (oder Runtime Environment bereits zuvor installiert zu haben) und das System neu zu starten.

#### 2.1.4 Wiederherstellen nach einer fehlgeschlagenen Installation

Wenn Ihre Installation von Developer Kit fehlschlägt, müssen Sie übrig gebliebene Installationsobjekte suchen und löschen. Wenn Sie diese Installationsobjekte nicht löschen, könnten zukünftige Installationen mit einer Nachricht fehlschlagen, dass eine oder mehrere Komponenten nicht installiert wurden, da das Objekt schreibgeschützt ist oder von einem anderen Prozess verwendet wird.

Bei einer CID-Installation (CID - Configuration, Installation, and Distribution - Konfiguration, Installation und Verteilung) besteht das Symbol für das Installationsobjekt aus einem blauen Kästchen mit einem roten Band und befindet sich auf dem Desktop. Bei einer überwachten Installation befindet sich das Objekt im Ordner x:\os2\install\. (Dabei steht x für das Bootlaufwerk). Klicken Sie das Objekt mit der rechten Maustaste an, und wählen Sie Löschen im Menü aus, um das Objekt zu löschen.

Alternativ dazu können Sie auch in das Verzeichnis wechseln, in dem sich das Objekt befindet, und die gesamte Verzeichnisbaumstruktur löschen. Das Verzeichnis heißt entweder "Install object" oder "Java 1.3 for OS/2" je nach dem Zeitpunkt, zu dem die Installation fehlschlug.

Führen Sie nach dem Löschen des Installationsobjekts einen Systemabschluss durch und starten Sie das System neu.

#### Wenn das Installationsobjekt nicht gelöscht werden kann:

Wurde das Installationsobjekt auch nach Durchführung der oben angegebenen Anweisungen nicht entfernt, gehen Sie wie folgt vor:

1. Wechseln Sie zu einer OS/2-Eingabeaufforderung.
2. Wechseln Sie zum Verzeichnis os2\install des Boot-Laufwerks.
3. Entfernen Sie das Java 1.3.1 for OS/2-Verzeichnis mit allen Unterverzeichnissen.
4. Starten Sie das System erneut.

#### 2.1.5 Installationsfehler trotz korrekter FixPak-Stufe

Wenn Sie sicher sind, dass Ihr System die erforderlichen FixPak-Stufen hat, die Installation aber wegen der automatischen FixPak-Prüfung nicht durchführen können, können Sie die automatische FixPak-Prüfung inaktivieren. Dazu haben Sie zwei Möglichkeiten:

Erste Möglichkeit:

1. Fügen Sie der Datei CONFIG.SYS die Anweisung JAVANOFPK=YES hinzu.
2. Starten Sie das System erneut und führen Sie den Installationsprozess für Developer Kit noch einmal durch.

Zweite Möglichkeit:

1. Wechseln Sie in dem Verzeichnis, in dem Sie die selbstextrahierenden Dateien ausgeführt haben, in das Verzeichnis der von Ihnen gewählten Sprache.
2. Editieren Sie die Datei CHECK.CMD. Suchen Sie folgende Anweisung:

            disablecheck="NO"

   Ändern Sie "NO" in "YES". (Diese Anweisung befindet sich ungefähr in Zeile 12 .)
3. Wechseln Sie zurück in das Verzeichnis, in dem Sie die selbstextrahierenden Dateien ausgeführt haben, und führen Sie die Dateien noch einmal aus.

### 2.2 Nicht überwachte Installation (CID)

Nicht überwachte Installationen oder CID-Installationen von Developer Kit werden von CLIFI, der Befehlszeilenschnittstelle von Feature Install, ausgeführt. Diese Installationen können 15 bis 20 Minuten und länger dauern. Nachdem das Installationsprogramm beendet ist, muss das System neu gestartet werden, um die Installation abzuschließen.

Für CLIFI sind zwei Antwortdateien erforderlich: JAVA131.RSP, die Antwortdatei von Developer Kit, und eine angepasste Antwortdatei, in der Sie die Standardauswahlen überschreiben können. Die im Installationspaket enthaltene Datei CID.RSP ist ein Beispiel für eine angepasste Antwortdatei. Diese und die Datei CID.CMD müssen für eine nicht überwachte Installation modifiziert werden.

Hinweis: Für die nicht überwachte Installation (CID-Installation) ist Feature Install Version 1.2.3 oder höher erforderlich. Wenn Netscape Communicator während der Installation von Developer Kit aktiv ist, schlägt die Installation fehl. Sie müssen Netscape Communicator schließen, bevor Sie den Installationsprozess starten.

#### 2.2.1 Ändern der CID-Antwortdatei

Die Datei CID.RSP enthält Variablen, mit denen Sie auswählen können, welche Komponenten auf welchem Ziellaufwerk und in welchem Verzeichnis installiert werden sollen. Standardmäßig werden durch die Datei CID.RSP alle Komponenten von Developer Kit installiert. Sie können diese Antwortdatei jedoch auch ändern und angeben, welche Komponenten installiert werden sollen. Stellen Sie vor Beginn der Installation sicher, dass Sie alle erforderlichen Dateien heruntergeladen und extrahiert haben. Wenn Sie Toolkit installieren, installieren Sie Runtime Environment ebenfalls, selbst wenn Runtime Environment bereits installiert wurde.

In der folgenden Tabelle werden die auswählbaren Komponenten und Variablen aufgelistet:

Komponente | Variable
Runtime Environment | JV13Runtime
Toolkit | JV13Toolkit
Beispiele (Samples) | JV13Samples
OS/2 ICAT Debugger für Java | JV13 Debugger
Liste der auswählbaren Komponenten und Variablennamen

Geben Sie in der Datei CID.RSP für jede zu installierende Komponente "selection=1" bzw. für jede Komponente, die Sie nicht installieren wollen, "selection=0" an. Beispiel:

- Installieren der Komponente Runtime Environment und der Komponente OS/2 ICAT Debugger
- Konfigurieren des Java-Plug-Ins für Netscape 4.x
- Konfigurieren des Java-Plug-Ins für IBM Web Browser for OS/2
- Installieren von Developer Kit als Standard-JVM
- Keine Installation von Toolkit und Beispielen

Definieren Sie die nachfolgenden Variablen wie angegeben:

         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:

Dies ist ein Beispiel. In der Datei CID.RSP finden Sie die genauen Komponenten und die ihnen zugeordneten Variablen. Hierbei gibt x das Laufwerk an, auf dem die Komponente installiert wird.

Jeder Variablen JV13xxConfig.Selection ist eine Variable JV13xx.Selection zugeordnet. Die Variable JV13xxConfig.Selection muss auf denselben Wert gesetzt werden wie die Variable JV13xx.Selection. Wenn Sie zum Beispiel JV13Toolkit.Selection=0 angeben, müssen Sie auch JV13ToolkitConfig.Selection=0 setzen. (Dabei steht xx für den Komponentennamen).

In dem obigen Beispiel müssen mehrere Variablen angegeben werden, damit Developer Kit korrekt installiert wird. Nachfolgend finden Sie die Variablen mit ihrer jeweiligen Definition:

JV13.LicenseAgree | Lizenzvereinbarung Mögliche Werte für diese Variable: DISAGREE und AGREE. Setzen Sie diese Variable auf AGREE, um anzugeben, dass Sie die Lizenzvereinbarung gelesen und akzeptiert haben. Wenn Sie die Variable nicht in AGREE ändern, kann Developer Kit nicht installiert werden.
JV13DefaultJVM.Selection | JVM Setzen Sie diese Variable auf den Wert "1", wenn Sie Developer Kit als Standard-JVM installieren wollen.
JV13MZFiles | Plug-In für IBM Web Browser for OS/2 Setzen Sie diese Variable auf den Wert "1", wenn Sie das Plug-In für IBM Web Browser for OS/2 konfigurieren wollen.
JV13NSFiles | Netscape-Plug-In Setzen Sie diese Variable auf den Wert "1", wenn Sie das Netscape-Plug-In konfigurieren wollen.

Wenn Sie die Bestätigungsfenster bei der Installation unterdrücken wollen, setzen Sie folgende Variable:

        java13.continue=UNATTENDED

##### 2.2.1.1 Installationslaufwerke der Komponenten

Toolkit wird im Verzeichnis \JAVA131 des Ziellaufwerks installiert. Wenn Sie Toolkit installieren, wird Runtime Environment automatisch auf demselben Laufwerk wie Toolkit installiert. Runtime Environment ist eine Voraussetzung für die Komponenten Toolkit, Beispiele (Samples) und Debugger.

Zur Angabe des Ziellaufwerks für die Komponenten Beispiele (Samples) und ICAT setzen Sie das Laufwerk auf den gewünschten Wert. Ist Developer Kit auf dem Ziellaufwerk vorhanden, wird es vom Installationsprogramm ersetzt.

#### 2.2.2 Starten der nicht überwachten Installation

Die Datei CID.CMD enthält einen Beispielbefehl CLIFI für eine CID-Installation. Der Installationsprozess wurde dahingehend geändert, dass eine mehrsprachige Installation möglich ist. Sie müssen daher in den Dateien CID.RSP die Variable für Ihre Sprache angeben. Die Sprachvariablen sind wie folgt definiert:

Sprache | Sprachvariable
Englisch | en
Französisch | fr
Deutsch | de
Italienisch | it
Japanisch | jp
Brasilianisches Portugiesisch | br
Vereinfachtes Chinesisch | cn
Spanisch | es
Traditionelles Chinesisch | tw
Sprache und zugeordnete Sprachvariable

Der Befehl CLIFI kann auch als einzeiliger Befehl in einer OS/2-Befehlszeile wie folgt eingegeben werden:

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

Verwenden Sie die folgende Variablenliste beim Setzen der Variablen in den oben genannten Dateien als Referenz.

Dabei gilt Folgendes:

/r2 | Gibt Laufwerk, Pfad und Namen der Benutzerantwortdatei an.
/r | Gibt den vollständigen Pfad für die Feature Install-Antwortdatei an.
xx | Gibt die Variable für die gewünschte Sprache an.
/b | Gibt das Boot-Laufwerk an.
/s | Gibt den vollständigen Pfad für die extrahierten Developer Kit-Dateien an.
/l1 und /l2 | Gibt die vollständigen Pfadangaben für die wahlfreien Protokolldateien an. Sehen Sie sich diese Dateien zusätzlich zur Datei \os2\install\wpinstal.log auf dem Boot-Laufwerk an, wenn während der Installation Probleme auftreten.

Wenn Sie die Bestätigungsfenster bei der Installation unterdrücken wollen, setzen Sie folgende Variable:

        java13.continue=UNATTENDED

#### 2.2.3 Rückkehrcode über erfolgreiche Installation bei fehlgeschlagener CID-Installation

Wenn der Rückkehrcode nach der CID-Installation von Developer Kit angibt, dass die Installation erfolgreich ausgeführt wurde, die Installation jedoch fehlgeschlagen ist, kann eine der folgenden Ursachen vorliegen:

- Sie haben den Wert der Variablen Java13LicenseAgree in Ihrer Antwortdatei nicht in "AGREE" geändert.
- Sie haben nicht die korrekte FixPak-Stufe auf Ihrem System.

Es wird empfohlen, dass CID-Administratoren eine FixPak-Prüfung vornehmen, um zu gewährleisten, dass die benötigte FixPak-Stufe verfügbar ist. (Weitere Informationen finden Sie im Abschnitt FixPaks.) In der Datei check.cmd im Verzeichnis x:\Java131 finden Sie ein Beispiel-Script für die Prüfung von FixPak-Stufen. (Dabei steht x:\ für das Laufwerk, auf dem Developer Kit installiert wurde.)

#### 2.2.4 Installationsfehler trotz korrekter FixPak-Stufe

Wenn Sie sicher sind, dass Ihr System die erforderlichen FixPak-Stufen hat, die Installation aber wegen der automatischen FixPak-Prüfung nicht durchführen können, sollten Sie die automatische FixPak-Prüfung inaktivieren. Dazu haben Sie zwei Möglichkeiten:

Erste Möglichkeit:

1. Fügen Sie der Datei CONFIG.SYS die Anweisung JAVANOFPK=YES hinzu.
2. Starten Sie das System erneut und führen Sie den Installationsprozess für Developer Kit noch einmal durch.

Zweite Möglichkeit:

1. Wechseln Sie in dem Verzeichnis, in dem Sie die selbstextrahierenden Dateien ausgeführt haben, in das Verzeichnis der von Ihnen gewählten Sprache.
2. Editieren Sie die Datei CHECK.CMD. Suchen Sie folgende Anweisung:

            disablecheck="NO"

   Ändern Sie "NO" in "YES". (Diese Anweisung befindet sich ungefähr in Zeile 12 .)
3. Führen Sie die nicht überwachte Installation noch einmal durch.

### 2.3 Installationsvoraussetzungen für NVDM/2

Eine NVDM/2-CID-Installation (NVDM/2 - NetView Distribution Manager/2) erfordert die Erstellung eines Profils sowie die Erstellung und Katalogisierung einer Änderungsdatei. Das NVDM/2-Profil erlaubt Ihnen nur die Angabe einer einzigen Antwortdatei. Für die nicht überwachte Installation von Developer Kit sind jedoch zwei Antwortdateien erforderlich. Darüber hinaus ist die Handhabung von Variablen und Argumenten in NVDM/2 anders als beim Programm Feature Install, das zum Installieren von Developer Kit verwendet wird.

Hinweis: Wenn Netscape Communicator während der Installation von Developer Kit aktiv ist, schlägt die Installation fehl. Sie müssen Netscape Communicator schließen, bevor Sie den Installationsprozess starten.

Im folgenden Abschnitt werden zwei Methoden zur Installation von Developer Kit mit NVDM/2 beschrieben.

#### 2.3.1 Statischer Befehl im NVDM/2-Profil

Geben Sie im NVDM/2-Profil alle CLIFI-Optionen in der Variablen PARMS an. Die Parameter müssen auf einer Zeile und in doppelten Anführungszeichen stehen:

         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"

Bei dieser Methode müssen Sie das Profil immer ändern, wenn sich die Namen des Quellenverzeichnisses oder der Protokolldatei ändern. Alternativ hierzu können Sie diese Werte auch wie folgt durch workstation-spezifische Werte ersetzen:

         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

Die zweite Methode erfordert eine separate Antwortdatei für jede Workstation. WorkstatName muss entsprechend gesetzt werden.

Verwenden Sie die folgende Variablenliste beim Setzen der Variablen in den oben genannten Dateien als Referenz.

Dabei gilt Folgendes:

d: | Gibt das temporäre Verzeichnis an.
/r | Gibt den vollständigen Pfad für die Feature Install-Antwortdatei an.
xx | Gibt die Variable für die gewünschte Sprache an.
/b | Gibt das Boot-Laufwerk an.
/s | Gibt den vollständigen Pfad für die extrahierten Developer Kit-Dateien an.
/l1 und /l2 | Gibt die vollständigen Pfadangaben für die wahlfreien Protokolldateien an. Sehen Sie sich diese Dateien zusätzlich zur Datei \os2\install\wpinstal.log auf dem Boot-Laufwerk an, wenn während der Installation Probleme auftreten.

### 2.4 Installieren von Developer Kit unter WorkSpace On-Demand 2.0

Hinweis: Wenn Netscape Communicator während der Installation von Developer Kit aktiv ist, schlägt die Installation fehl. Sie müssen Netscape Communicator schließen, bevor Sie den Installationsprozess starten.

Zum Lieferumfang von WorkSpace On-Demand 2.0 gehört Java 1.1.6 für OS/2 Warp. Sie können Developer Kit (Version 1.3) auf WorkSpace On-Demand-Servern und -Clients installieren. Developer Kit kann gemeinsam mit Java 1.1.x für OS/2 Warp installiert sein. In den folgenden Abschnitten finden Sie Informationen zur Installation von Developer Kit auf WorkSpace On-Demand-Servern und -Clients und als Standard-JVM.

#### 2.4.1 Installieren von Developer Kit auf einem WorkSpace On-Demand 2.0-Server

Verwenden Sie die grafische Benutzerschnittstelle (GUI), um Developer Kit auf einem WorkSpace On-Demand-Server zu installieren. Anweisungen dazu finden Sie im Abschnitt GUI-Installation dieses Handbuchs.

#### 2.4.2 Installieren von Developer Kit auf einem WorkSpace On-Demand 2.0-Client

Führen Sie eine nicht überwachte Installation (CID) aus, um Developer Kit auf einem WorkSpace On-Demand-Client zu installieren. Beachten Sie die Anweisungen im Abschnitt Nicht überwachte Installation (CID) und verwenden Sie die Dateien CID.CMD und WSOD2.RSP, die im Installationspaket von Developer Kit enthalten sind. Die Installationsschritte werden auf einem WorkSpace On-Demand 2.0-Server ausgeführt.

Hinweis: Wenn Sie Developer Kit als Standard-JVM auf WorkSpace On-Demand-Clients installieren wollen, müssen die Verweise auf die Verzeichnisse und Dateien in `z:\JAVA131` vor den Verweisen auf `z:\JAVA11` in der Datei CONFIG.SYS stehen.

##### 2.4.2.1 Nicht überwachte Installation für einen WorkSpace On-Demand 2.0-Client

Führen Sie die folgenden Schritte aus:

1. Ändern Sie in der Datei CID.CMD `/r2:cid.rsp` in `/r2:wsod2.rsp`. (Dabei gibt `/r2` Laufwerk, Pfad und Namen der Benutzerantwortdatei an).
2. Gehen Sie wie im Abschnitt Starten der nicht überwachten Installation dieses Handbuchs beschrieben vor:
   - Ersetzen Sie `/s:d:\tmp\xx` in der Datei CID.CMD durch das Laufwerk und das Verzeichnis, auf/in dem Sie das Installationspaket entpackt haben. (Dabei gibt `xx` die Variable für die gewünschte Sprache an).
   - Stellen Sie sicher, dass `/b:z` in der Datei CID.CMD auf das Bootlaufwerk des Clients zeigt.
3. Prüfen Sie, ob die Auswahlen in der Datei WSOD2.RSP den Komponenten entsprechen, die Sie installieren wollen. Standardmäßig wird nur Runtime Environment zur Installation ausgewählt. Stellen Sie sicher, dass Sie alle erforderlichen Dateien heruntergeladen und extrahiert haben. Außerdem müssen Sie, nachdem Sie die Lizenzvereinbarung gelesen und akzeptiert haben, die Auswahlvariable Java13.LicenseAgree in der Datei WSOD2.RSP auf AGREE setzen. Wenn Sie diese Variable nicht in AGREE ändern, kann Runtime Environment nicht installiert werden.
4. Führen Sie die aktualisierte Datei CID.CMD aus, indem Sie den Dateinamen an einer Eingabeaufforderung eingeben.

Informationen zum Abschließen der nicht überwachten Installation finden Sie in den folgenden Abschnitten.

##### 2.4.2.2 Ändern der CONFIG.SYS-Dateien für WorkSpace On-Demand 2.0-Clients

Der WorkSpace On-Demand-Administrator muss die CONFIG.SYS-Dateien für die WorkSpace On-Demand-Clients wie folgt ändern, um die Runtime Environment-Komponente von Developer Kit zu aktivieren:

Fügen Sie Folgendes hinzu:

`z:\JAVA131\jre\dll` | in der Anweisung LIBPATH
`z:\JAVA131\jre\bin;` | in der Anweisung SET PATH

Für die Position der Datei CONFIG.SYS und das Editieren für WorkSpace On-Demand-Clients gilt Folgendes:

- Wollen Sie die Datei CONFIG.SYS vom Server aus für einen bestimmten Benutzer ändern, befindet sie sich im folgenden Laufwerk und Verzeichnis:

         [rpl-laufwerk]:\ibmlan\rpl\machines\[clientname]\config.sys

- Wollen Sie die Standarddatei CONFIG.SYS für jede Maschine ändern, die mit einer bestimmten Maschinenklasse erstellt wurde, befindet sich die Datei im folgenden Laufwerk und Verzeichnis:

         [rpl-laufwerk]:\ibmlan\rpl\machines\BB20.xx\[maschinenklasse]\config.sys

Dabei gilt Folgendes:

[rpl-laufwerk] | Gibt das Laufwerk an, auf dem das RPL-Verzeichnis installiert ist.
[client-name] | Gibt den Namen des WorkSpace On-Demand-Clients an.
xx | Gibt den Landes- bzw. Regionscode an.
[maschinenklasse] | Gibt den Namen der Maschine an.

##### 2.4.2.3 Ändern von FIT-Dateien und Erteilen von Zugriff auf WorkSpace On-Demand 2.0-Clients

Der WorkSpace On-Demand-Administrator muss die FIT-Dateien (File Index Table) für die WorkSpace On-Demand-Clients wie folgt ändern, um Runtime Environment zu aktivieren:

Fügen Sie Folgendes hinzu:

         z:\JAVA131      BB20.xx\JAVA131

Für die Position und das Editieren der FIT-Dateien für WorkSpace On-Demand-Clients gilt Folgendes:

- Wollen Sie die Datei [client-name].FIT vom Server aus für einen bestimmten Benutzer ändern, befindet sie sich im folgenden Laufwerk und Verzeichnis:

         [rpl-laufwerk]:\ibmlan\rpl\fits\[clientname].FIT

- Wollen Sie die Standarddatei DFBB20xx.FIT ändern, befindet sich die Datei im folgenden Laufwerk und Verzeichnis:

         [rpl-laufwerk]:\ibmlan\rpl\fits\DFBB20xx.FIT

Der WorkSpace On-Demand-Administrator muss den WorkSpace On-Demand-Clients außerdem Lese- und Ausführungszugriff auf das Verzeichnis JAVA131 erteilen:

Führen Sie folgende LAN-Server-Befehle aus:

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

Dabei gilt Folgendes:

[rpl-laufwerk] | Gibt das Laufwerk an, auf dem das RPL-Verzeichnis installiert ist.
[client-name] | Gibt den Namen des WorkSpace On-Demand-Clients an.
xx | Gibt den Landes- bzw. Regionscode an.

##### 2.4.2.4 Zuordnen des Verzeichnisses USER_HOME für WorkSpace On-Demand 2.0-Clients

Das Verzeichnis USER_HOME für Developer Kit muss über Schreib-/Lesezugriff verfügen, weil dort Sicherheitszertifikate und Plug-In-Merkmaldateien erstellt werden und auf diese zugegriffen wird. Sie können zum Beispiel `z:\JAVA13_RW` als das Verzeichnis USER_HOME angeben und für dieses Verzeichnis den Schreib-/Lesezugriff erteilen, indem Sie der FIT-Datei Folgendes hinzufügen (die Eingabe muss auf einer fortlaufenden Zeile erfolgen):

         z:\JAVA13_RW \\servername\WRKFILES\clientname\JAVA_RW

Die Namen des WorkSpace On-Demand-Servers und -Clients müssen für servername bzw. clientname eingesetzt werden. Dabei ist z das Laufwerk, auf dem Runtime Environment installiert ist. Diese Anweisungen können auch in die Standard-FIT-Datei eingegeben werden.

Außerdem muss der WorkSpace On-Demand-Administrator die OS2.INI-Dateien für die WorkSpace On-Demand-Clients wie folgt ändern. Die Anfügung muss ein Nullabschlusszeichen haben.

Fügen Sie Folgendes hinzu:

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

Informationen zum Hinzufügen von INI-Dateieinträgen für WorkSpace On-Demand-Clients mit Hilfe eines INI-Editors oder des Befehls NET APPPARM finden Sie im Handbuch WorkSpace On-Demand 2.0 Verwaltung. Für die Position der Datei OS2.INI für WorkSpace On-Demand-Clients gilt Folgendes:

- Vom Server für einen bestimmten Benutzer:

           [rpl-laufwerk]:\ibmlan\rpluser\[clientname]\os2\os2.ini

- Wollen Sie die Standarddatei OS2.INI für jede Maschine ändern, die mit einer bestimmten Maschinenklasse erstellt wurde, befindet sich die Datei auf dem folgenden Laufwerk und im folgenden Verzeichnis:

           [rpl-laufwerk]:\ibmlan\rpl\machines\BB20.xx\[maschinenklasse]\os2\os2.ini

Dabei gilt Folgendes:

z | Gibt das Laufwerk an, auf dem Runtime Environment für den Client installiert wurde.
[rpl-laufwerk] | Gibt das Laufwerk an, auf dem das RPL-Verzeichnis installiert ist.
[client-name] | Gibt den Namen des WorkSpace On-Demand-Clients an.
xx | Gibt den Landes- bzw. Regionscode an.
[maschinenklasse] | Gibt den Namen der von einem WorkSpace On-Demand-Client verwendeten Maschinenklasse an.

##### 2.4.2.5 Aktivieren von Schriftarten für WorkSpace On-Demand 2.0-Clients

Der WorkSpace On-Demand-Administrator muss die OS2.INI-Dateien für die WorkSpace On-Demand-Clients wie folgt ändern, um die Schriftarten für Runtime Environment zu aktivieren. Alle Anfügungen müssen auf Null enden. z steht für das Laufwerk, auf dem Runtime Environment für den Client installiert wurde.

Fügen Sie Folgendes hinzu:

      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

Informationen zum Hinzufügen von INI-Dateieinträgen für WorkSpace On-Demand-Clients mit Hilfe eines INI-Editors oder des Befehls NET APPPARM finden Sie im Handbuch WorkSpace On-Demand 2.0 Verwaltung. Für die Position der Datei OS2.INI für WorkSpace On-Demand-Clients gilt Folgendes:

- Wollen Sie die Datei OS2.INI vom Server aus für einen bestimmten Benutzer ändern, befindet sie sich im folgenden Laufwerk und Verzeichnis:

         [rpl-laufwerk]:\ibmlan\rpluser\[clientname]\os2\os2.ini

- Wollen Sie die Standarddatei OS2.INI für jede Maschine ändern, die mit einer bestimmten Maschinenklasse erstellt wurde, befindet sich die Datei auf dem folgenden Laufwerk und im folgenden Verzeichnis:

         [rpl-laufwerk]:\ibmlan\rpl\machines\BB20.xx\[maschinenklasse]\os2\os2.ini

Dabei gilt Folgendes:

[rpl-laufwerk] | Gibt das Laufwerk an, auf dem das RPL-Verzeichnis installiert ist.
[clientname] | Gibt den Namen des WorkSpace On-Demand-Clients an.
xx | Gibt den Landes- bzw. Regionscode an.
[maschinenklasse] | Gibt den Namen der von einem WorkSpace On-Demand-Client verwendeten Maschinenklasse an.

##### 2.4.2.6 Installieren des Netscape-Plug-Ins für WorkSpace On-Demand 2.0-Clients

Zum Installieren des Java-Plug-Ins für einen Netscape-Browser ab Version 4.0 muss der WorkSpace On-Demand-Administrator die Datei npjava.dll in das Plug-In-Verzeichnis von Netscape 4.x des WorkSpace On-Demand-Clients kopieren. Geben Sie zum Kopieren der Datei Folgendes ein:

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

Zum Installieren des Java-Plug-Ins für IBM Web Browser for OS/2 müssen Sie die Datei npoji6.dll in das Plug-In-Verzeichnis von IBM Web Browser for OS/2 des WorkSpace On-Demand-Clients kopieren. Geben Sie zum Kopieren der Datei Folgendes ein:

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

Dabei gilt Folgendes:

d:\JavaTemp | Gibt den vollständigen Pfad für die extrahierten Runtime Environment-Dateien an.
[rpl-laufwerk] | Gibt das Laufwerk an, auf dem das RPL-Verzeichnis installiert ist.
xx | Gibt den Landes- bzw. Regionscode an.

Außerdem muss der WorkSpace On-Demand-Administrator die OS2.INI-Dateien für die WorkSpace On-Demand-Clients wie folgt ändern. Alle Anfügungen müssen auf Null enden.

Fügen Sie Folgendes hinzu:

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

Dabei steht z für das Laufwerk, auf dem Runtime Environment für den Client installiert wurde.

Informationen zum Hinzufügen von INI-Dateieinträgen für WorkSpace On-Demand-Clients mit Hilfe eines INI-Editors oder des Befehls NET APPPARM finden Sie im Handbuch WorkSpace On-Demand 2.0 Verwaltung. Für die Position der Datei OS2.INI für WorkSpace On-Demand-Clients gilt Folgendes:

- Wollen Sie die Datei OS2.INI vom Server aus für einen bestimmten Benutzer ändern, befindet sie sich im folgenden Laufwerk und Verzeichnis:

         [rpl-laufwerk]:\ibmlan\rpluser\[clientname]\os2\os2.ini

- Wollen Sie die Standarddatei OS2.INI für jede Maschine ändern, die mit einer bestimmten Maschinenklasse erstellt wurde, befindet sich die Datei auf dem folgenden Laufwerk und im folgenden Verzeichnis:

         [rpl-laufwerk]:\ibmlan\rpl\machines\BB20.xx\[maschinenklasse]\os2\os2.ini

Dabei gilt Folgendes:

[rpl-laufwerk] | Gibt das Laufwerk an, auf dem das RPL-Verzeichnis installiert ist.
[clientname] | Gibt den Namen des WorkSpace On-Demand-Clients an.
xx | Gibt den Landes- bzw. Regionscode an.
[maschinenklasse] | Gibt den Namen der von einem WorkSpace On-Demand-Client verwendeten Maschinenklasse an.

##### 2.4.2.7 Installieren weiterer Komponenten von Developer Kit auf dem WorkSpace On-Demand 2.0-Client

Wollen Sie andere Komponenten als Runtime Environment für den WorkSpace On-Demand-Client installieren, können Sie diese Komponenten in der Datei WSOD2.RSP auswählen.

Wenn Sie das Toolkit installieren wollen, muss der WorkSpace On-Demand-Administrator die CONFIG.SYS-Dateien für die Clients wie folgt ändern.
Fügen Sie Folgendes hinzu:

`x:\java131\bin;` | in der Anweisung SET PATH
`z:\JAVA131\lib;` | in der Anweisung SET LIB
`z:\JAVA131\include;` | in der Anweisung SET INCLUDE

Dabei steht z:\JAVA131 für das Laufwerk und das Verzeichnis, auf/in dem Toolkit für den Client installiert wurde.

##### 2.4.2.8 Ausführen von Java-Beispielen von einem WorkSpace On-Demand 2.0-Client aus

Der WorkSpace On-Demand-Serveradministrator muss der Datei RPL\FITS\clientname.FIT die folgenden Zeilen hinzufügen, damit der WorkSpace On-Demand-Client die in der Komponente Samples (Beispiele) enthaltenen Beispiele ausführen kann:

         z:\JAVA131\WEBLOGS \\servername\WRKFILES\clientname\JAVA131\WEBLOGS
         z:\JAVA131\HOTJAVA \\servername\WRKFILES\clientname\JAVA131\HOTJAVA

Die Namen des RIPL-Servers und des RIPL-Clients müssen dabei für servername bzw. clientname eingesetzt werden. Dabei ist z das Laufwerk, auf dem Developer Kit installiert ist. Diese Anweisungen können auch in die Standard-FIT-Datei eingegeben werden.

Die RIPL-Clients können den Beispielcode kompilieren, wenn die Beispiele sich in einem Verzeichnis befinden, auf das der RIPL-Client Schreibzugriff hat.

##### 2.4.2.9 Definieren einer sicheren Verbindung zu einem WorkSpace On-Demand 2.0-Client

Wenn Sie eine sichere Verbindung zu einem Web-Server definieren (Zugriff erteilen) wollen, muss auf die Datei IDENTITYDB.OBJ Schreib-/Lesezugriff bestehen. Fügen Sie der FIT-Datei folgende Einträge hinzu, um die Verbindung herzustellen:

         z:\JAVA131\WEBLOGS        \\servername\WRKFILES\clientname\JAVA131\WEBLOGS
         z:\JAVA131\HOTJAVA        \\servername\WRKFILES\clientname\JAVA131\HOTJAVA
         z:\JAVA131\IDENTITYDB.OBJ \\servername\WRKFILES\clientname\JAVA131\IDENTITYDB.OBJ

##### 2.4.2.10 Der JIT-Compiler und ein WorkSpace On-Demand 2.0-Client

Auf einem WorkSpace On-Demand-Clientsystem wird der Datei CONFIG.SYS der folgende Befehl hinzugefügt, wenn Developer Kit Version 1.1.6 bei der Installation des WorkSpace On-Demand-Servers installiert wurde:

        set java_compiler=xxx

Dieser Befehl inaktiviert den JIT-Compiler (Just-In-Time Compiler).

Entfernen Sie den zuvor angegebenen Befehl aus Ihrer Datei CONFIG.SYS, um den JIT-Compiler zu aktivieren. Für die Position dieser Datei gilt Folgendes:

- Wollen Sie die Datei CONFIG.SYS vom Server aus für einen bestimmten Benutzer ändern, befindet sie sich auf dem folgenden Laufwerk und im folgenden Verzeichnis:

         [rpl-laufwerk]:\ibmlan\rpl\machines\[maschinenklasse]\config.sys

- Wollen Sie die Standarddatei CONFIG.SYS für jede Maschine ändern, die mit einer bestimmten Maschinenklasse erstellt wurde, befindet sich die Datei auf dem folgenden Laufwerk und im folgenden Verzeichnis:

         [rpl-laufwerk]:\ibmlan\rpl\machines\BB20.xx\[maschinenklasse]\config.sys

Verwenden Sie die folgende Variablenliste beim Setzen der Variablen in den oben genannten Dateien als Referenz.

Dabei gilt Folgendes:

[rpl-laufwerk] | Gibt die Anforderungsparameterliste an.
xx | Gibt den Landes- bzw. Regionscode an.
[maschinenklasse] | Gibt den Namen der von einem WorkSpace On-Demand-Client verwendeten Maschinenklasse an.

##### 2.4.2.11 Erstellen einer allgemeinen Anwendung der Java-Plug-In-Steuerkonsole für den WorkSpace On-Demand 2.0-Client

Zum Erstellen einer allgemeinen, auf einem WorkSpace On-Demand 2.0-Client ausgeführten Anwendung für die Java-Plug-In-Steuerkonsole müssen Sie den Zugriff auf die Netscape-Dateien ermöglichen. Die Zugriffssteuerung wird in der Netscape-Datei APPPOST.FIT festgelegt.

Das folgende Beispiel zeigt, wie Sie eine allgemeine Anwendung für die Ausführung der Java-Plug-In-Steuerkonsole erstellen:

         net app jctrlpnl /remark:"Java-Plug-in-Steuerkonsole"
           /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 gibt an, wo das Developer Kit-Image installiert ist. z:\netscape ist das Verzeichnis, in dem das Netscape-Image installiert ist.

### 2.5 RIPL-Installation

Eine RIPL-Installation erfordert das Erstellen von zwei Antwortdateien und das Einrichten der entsprechenden Verzeichnisse und Dateien auf dem RIPL-Server.

Führen Sie für jeden zu installierenden Client die folgenden Schritte aus:

1. Speichern Sie die extrahierten Installationsdateien für Developer Kit auf dem RIPL-Server.
2. Führen Sie den Befehl GENFIRPL aus. (Weitere Informationen finden Sie im Abschnitt Erstellen von Antwortdateien.)
3. Führen Sie den Befehl CLIFI für einen RIPL-Client aus. (Weitere Informationen finden Sie im Abschnitt Starten der RIPL-Installation.)
4. Ändern Sie die FIT-Datei des Clients. (Siehe die Abschnitte Aktualisieren von Dateien für Feature Install und Ausführen von Java-Beispielen von einem RIPL-Client aus.)

#### 2.5.1 Erstellen von Antwortdateien

Nach dem Speichern der extrahierten Installationsdateien von Developer Kit auf dem RIPL-Server wird der Befehl GENFIRPL verwendet, um zwei Antwortdateien zu erstellen: FILES.RSP für den RIPL-Server und JAVA131.RSP für den RIPL-Client. Nachfolgend finden Sie ein Beispiel für den Befehl GENFIRPL. Die Eingabe muss auf einer Zeile stehen.

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

Der RIPL-Client muss nicht aktiv sein, wenn der Befehl GENFIRPL abgesetzt wird. Für jeden RIPL-Client muss ein Befehl GENFIRPL abgesetzt werden, der den Namen und das Boot-Laufwerk des Clients angibt.

Verwenden Sie die folgende Variablenliste beim Setzen der Variablen in der bzw. den oben genannten Datei(en) als Referenz.

Dabei gilt Folgendes:

/m | Gibt das Verzeichnis mit den Installationsdateien von Developer Kit auf dem RIPL-Server an.
xx | Gibt die Variable für die gewünschte Sprache an.
/r | Gibt das RPL-Verzeichnis an.
/u | Gibt das RPLUSER-Verzeichnis an.
/f | Gibt den vollständig qualifizierten Namen der Antwortdatei des RIPL-Clients an.
/c | Gibt den Namen des RIPL-Clients an.
/b | Gibt das Boot-Laufwerk des RIPL-Clients an.
/nf | Unterdrückt die Übertragung von Java-Dateien. Verwenden Sie diese Option, wenn Sie nach dem ersten RIPL-Client weitere Clients dieser Art installieren möchten. Sie verhindern so, dass die Dateien von Developer Kit für jeden neuen Client erneut installiert werden.

#### 2.5.2 Ändern der Datei JAVA131.RSP

Die Datei JAVA131.RSP enthält Variablen, mit denen Sie auswählen können, welche Komponenten auf welchem Ziellaufwerk und in welchem Verzeichnis installiert werden sollen. Standardmäßig werden durch die Datei JAVA131.RSP alle Komponenten von Developer Kit installiert. Sie können diese Antwortdatei jedoch auch ändern und angeben, welche Komponenten installiert werden sollen. Stellen Sie vor Beginn der Installation sicher, dass Sie alle erforderlichen Dateien heruntergeladen und extrahiert haben.

Sie müssen einen Texteditor verwenden, der Zeilen mit mehr als 255 Zeichen bearbeiten kann, z. B. TEDIT, um das Abschneiden von langen Zeilen in dieser Datei zu verhindern. Da diese Datei sehr groß ist, können Änderungen zeitaufwendig und fehlerträchtig sein. Es empfiehlt sich, vor dem Ändern eine Sicherungskopie von JAVA131.RSP zu erstellen, um den Verlust von Daten zu verhindern.

#### 2.5.3 Aktualisieren von Dateien für Feature Install

Die Datei client-name.FIT für jeden RIPL-Client muss geändert werden, so dass sie die folgende Zeile enthält (die Angaben müssen in einer Zeile stehen):

         z:\os2\install\install.inv \\server-name\WRKFILES\client-name
         \os2\install\install.inv

Dabei müssen die Namen des RIPL-Servers und des RIPL-Clients für server-name bzw. client-name eingesetzt werden. Dabei ist z das Laufwerk, auf dem Developer Kit installiert ist.

#### 2.5.4 Starten der RIPL-Installation

RIPL-Installationen (RIPL - Remote Initial Program Load) werden von CLIFI, der Befehlszeilenschnittstelle von Feature Install, ausgeführt und können 15 bis 20 Minuten oder länger dauern. Melden Sie sich am RIPL-Server als Administrator an, und führen Sie den Befehl CLIFI mit der Antwortdatei für den RIPL-Server, FILES.RSP, aus:

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

Wurde die Dateiübertragung nicht unterdrückt, muss auf dem RIPL-Server nach der Ausführung von CLIFI ein Systemabschluss durchgeführt und dieser Server erneut gestartet werden.

Führen Sie den Befehl CLIFI für jeden RIPL-Client aus, nachdem Sie den Befehl GENFIRPL für diesen Client ausgeführt haben.

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

Verwenden Sie die folgende Variablenliste beim Setzen der Variablen in den oben genannten Dateien als Referenz.

Dabei gilt Folgendes:

/r | Gibt den vollständig qualifizierten Namen der Antwortdatei des RIPL-Clients entsprechend der Angabe im Befehl GENFICMD an.
xx | Gibt die Variable für die gewünschte Sprache an.

#### 2.5.5 Ausführen von Java-Beispielen von einem RIPL-Client aus

Der RIPL-Server-Administrator muss der Datei RPL\FITS\client-name.FIT die folgenden Zeilen hinzufügen, damit der RIPL-Client die in der Komponente Samples (Beispiele) enthaltenen Beispiele ausführen kann:

         z:\JAVA131\WEBLOGS \\servername\WRKFILES\clientname\JAVA131\WEBLOGS
         z:\JAVA131\HOTJAVA \\servername\WRKFILES\clientname\JAVA131\HOTJAVA

Die Namen des RIPL-Servers und des RIPL-Clients müssen für servername bzw. clientname eingesetzt werden. Dabei ist z das Laufwerk, auf dem Developer Kit installiert ist.

Die RIPL-Clients können den Beispielcode kompilieren, wenn die Beispiele sich in einem Verzeichnis befinden, auf das der RIPL-Client Schreibzugriff hat.

##### 2.5.5.1 Definieren einer sicheren Verbindung auf einem RIPL-Client

Wenn Sie eine sichere Verbindung zu einem Web-Server definieren wollen, muss auf die Datei IDENTITYDB.OBJ Schreib-/Lesezugriff bestehen. Fügen Sie der FIT-Datei folgende Einträge hinzu, um die Verbindung herzustellen:

         z:\JAVA131\WEBLOGS \\servername\WRKFILES\clientname\JAVA131\WEBLOGS
         z:\JAVA131\HOTJAVA \\servername\WRKFILES\clientname\JAVA131\HOTJAVA
         z:\JAVA131\IDENTITYDB.OBJ  \\server\WRKF\client\JAVA131\IDENTITYDB.OBJ

Die Namen des RIPL-Servers und des RIPL-Clients müssen für servername bzw. clientname eingesetzt werden. Dabei ist z das Laufwerk, auf dem Developer Kit installiert ist.

Diese Anweisungen können auch während der Installation von Developer Kit für WorkSpace On-Demand in die Standard-FIT-Datei eingegeben werden, wenn Sie den Befehl WSOD.CMD ausführen.

## 3.0 NACH DER INSTALLATION

Die folgenden Abschnitte enthalten zusätzliche Informationen, die Sie nach der Installation von Developer Kit möglicherweise benötigen.

### 3.1 Weitere Informationsquellen

Die nachfolgend aufgelisteten Objekte werden im Ordner Java Developer Kit for OS/2 nur angezeigt, wenn Developer Kit unter OS/2 Warp Server 4 ausgeführt wird. Wenn Sie mit OS/2 Warp Server for e-business arbeiten, können Sie auf die zugehörigen Dokumente an den folgenden Speicherpositionen zugreifen:

- IBM Homepage für Java-Technologie:
  http://www.ibm.com/java/jdk/index.html
- Java-Dokumentation:
  http://www.javasoft.com/doc.html
- ICAT Debugger für OS/2 Java:
  `x:\JAVA131\ICATJAVA\help\icatjvo.htm`
- Developer Kit-README (Informationsdatei)
  `x:\JAVA131\`

Dabei ist x das Laufwerk, auf dem Developer Kit installiert ist.

Wenn Sie Toolkit oder den ICAT Debugger für Java OS/2 in anderen Verzeichnissen als Runtime Environment installiert haben, geben Sie das entsprechende Verzeichnis für diese beiden Objekte an. Die Verbindungen zur Runtime Environment-Dokumentation und dem ICAT Debugger für Java OS/2 funktionieren nicht, wenn die Komponenten in unterschiedlichen Verzeichnissen oder gar nicht installiert sind.

### 3.2 Installieren weiterer Komponenten

Nach der Erstinstallation von Developer Kit können Sie weitere Komponenten installieren, indem Sie das Installationsverfahren erneut durchführen. Dies setzt voraus, dass Sie die Dateien noch einmal von der IBM Software Choice-Homepage herunterladen, alle extrahierten Dateien auf Ihrem System behalten oder die ZIP-Dateien behalten und die Dateien ggf. erneut extrahieren.

### 3.3 Überlegungen zu den AWT-Steuerelementen "TextField" und "TextArea"

Die AWT-Steuerelemente (AWT - Abstract Window Toolkit) "TextField" und "TextArea" unterstützen keine Zeichen außerhalb der aktuellen Codepage. Benutzer mit US-englischen oder deutschen Systemen können zur Codepage 850 (die mehrsprachige Codepage, die die westeuropäischen Sprachen unterstützt) umschalten, um weitere Sprachzeichen in diesen Steuerelementen zu sehen.

### 3.4 Änderung der Dateien mit Schriftarteinstellungen wird nicht unterstützt

Das Ändern der Dateien mit den Schriftarteinstellungen wird im Developer Kit nicht unterstützt.

### 3.5 Probleme mit der Zeiteinstellung in Java-Applets

Wenn in Ihren Java-Applets Probleme mit der Zeiteinstellung auftreten, müssen Sie möglicherweise die Variable für die Zeitzone (TZ) setzen oder ändern. Gehen Sie nach einer der folgenden Methoden vor, um die Variable TZ zu setzen:

- Rufen Sie die Seite Allgemein des Notizbuchs TCP/IP-Konfiguration auf. Definieren Sie das Feld für die Zeitzone wie in der Onlinehilfe angegeben.
- Editieren Sie die Datei CONFIG.SYS, und fügen Sie die Anweisung SET TZ= hinzu oder ändern Sie diese.

### 3.6 Verwenden der OS/2-High Memory-Unterstützung zur Erhöhung der Java-Freispeichergröße

In einer OS/2-Standardumgebung beträgt der virtuelle Adressraum, der einer Anwendung zur Verfügung steht, maximal 512 MB und der für den Java-Freispeicher verfügbare Speicher beschränkt sich auf ungefähr 256 MB. Diese Einschränkung können Sie mit Hilfe der OS/2-High Memory-Unterstützung aufheben. Die OS/2-High Memory-Unterstützung erhöht den maximal verfügbaren virtuellen Adressraum einer Anwendung auf drei GB.

Die OS/2-High Memory-Unterstützung wird auf folgenden Plattformen unterstützt:

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

#### 3.6.1 Aktivieren der OS/2-High Memory-Unterstützung

Das verfügbare High Memory wird über den Wert VIRTUALADDRESSLIMIT gesteuert, der in der Datei CONFIG.SYS eingestellt wird. Der Wert wird in MB in der Datei CONFIG.SYS angegeben. Beispiel:

            VIRTUALADDRESSLIMIT=2048

Der kleinste zulässige Wert ist 512 MB. Damit wird die Kompatibilität mit früheren OS/2-Versionen gewährleistet, in denen 512 MB erlaubt waren. Werte über 512 MB können die Zahl der Prozesse verringern, die gleichzeitig auf einem System ablaufen können.

#### 3.6.2 Aktivieren des Java-Freispeichers für die Verwendung der OS/2-High Memory-Unterstützung

Sie müssen die folgende Umgebungsvariable einstellen, um der virtuellen Java-Maschine (JVM) anzugeben, dass sie versuchen soll, ihren Freispeicher in die OS/2 High Memory-Unterstützung zu stellen:

        SET JAVA_HIGH_MEMORY=1

Ist die OS/2-High Memory-Unterstützung nicht verfügbar, wird diese Option ignoriert und der Freispeicher wird vom Standardadressraum aus zugeordnet.

#### 3.6.3 Einschränkungen bei der Verwendung der OS/2-High Memory-Unterstützung

Wird der Java-Freispeicher in die OS/2-High Memory-Unterstützung gestellt, kann auf die daraus zugeordneten Objekte nicht mit dem 16-Bit-Code zugegriffen werden. Das ist jedoch nur dann problematisch, wenn eine Java-Anwendung DLLs für Basismethoden enthält, die entweder mit einem 16-Bit-Compiler kompiliert wurden oder andere DLLs aufrufen, die den 16-Bit-Code enthalten.

### 3.7 Die erweiterte Klasse BigDecimal

Dieses Release enthält die Klasse BigDecimal (com.ibm.math.BigDecimal). Sie wird (zusammen mit der unterstützenden Klasse MathContext) als Alternative zur Klasse java.math.BigDecimal angeboten. Wenn Sie in einem Java-Programm die Klasse java.math.BigDecimal bereits verwendet haben und auf die neue Klasse zugreifen wollen, ändern Sie in Ihrem Quellencode die Anweisung 'import' wie nachfolgend gezeigt.

Ändern Sie:

         import java.math.*;

In:

         import com.ibm.math*;

Weitere Codeänderungen sind nicht erforderlich.

### 3.8 Die Java-Plug-Ins

Die folgenden Abschnitte enthalten Informationen zum Installieren und Verwenden der Java-Plug-Ins für Netscape 4x und IBM Web Browser for OS/2.

#### 3.8.1 Installieren des Java-Plug-Ins nach der Installation von Netscape Communicator

Wenn Sie Netscape Communicator nach Developer Kit installiert haben und das Java-Plug-In aktivieren wollen, müssen Sie folgende Schritte ausführen:

1. Suchen Sie die Datei plugin.exe. Sie befindet sich im Verzeichnis \JAVA131\ns\ von Runtime Environment. Kopieren Sie die Datei plugin.exe in ein temporäres Verzeichnis.
2. Führen Sie die Datei plugin.exe in dem Verzeichnis aus, in das Sie diese Datei kopiert haben, indem Sie den Dateinamen an einer Eingabeaufforderung eingeben. Durch die Ausführung der Datei werden folgende Dateien extrahiert:
   - instplug.cmd: CLIFI-Befehl zur Ausführung der Installation des Java-Plug-Ins
   - npjava.dll: DLL für das Java-Plug-In
   - nscheck2.exe: Benutzer-Exit zur Suche von Netscape
   - nsfiles.rsp: Antwortdatei für Feature Install (FI). Editieren Sie diese Datei nicht.
   - nsuser.rsp: Teilantwortdatei für Benutzer als Beispiel
   - package.ctl: Eine für Feature Install erforderliche Paketdatei
3. Gehen Sie zurück in das Verzeichnis \JAVA131\ns\.
4. Editieren Sie die Datei instplug.cmd so, dass sie auf die korrekten Pfade und das korrekte Boot-Laufwerk zeigt.
5. Editieren Sie die Datei nsuser.rsp, um das Java-Plug-In zu aktivieren. Die neueste Netscape Communicator-Version wird aktiviert. (Wenn Sie eine bestimmte Version von Netscape aktivieren wollen, setzen Sie die Variable JAVANSFILES.NSDRV in der Datei nsuser.rsp auf das Laufwerk und den vollständig qualifizierten Pfad.)
6. Führen Sie die Datei instplug.cmd aus.
7. Starten Sie das System erneut.

Verwenden Sie die folgende Variablenliste beim Setzen der Variablen in den oben genannten Dateien als Referenz.

Dabei gilt Folgendes:

xx | Gibt die Variable für die gewünschte Sprache an.
/r | Gibt den vollständigen Pfad für die Feature Install-Antwortdatei an.
/r2 | Gibt Laufwerk, Pfad und Namen der Benutzerantwortdatei an.
/b | Gibt das Boot-Laufwerk an.
/s | Gibt den vollständigen Pfad für die extrahierten Developer Kit-Dateien an.
/l1 und /l2 | Gibt die vollständigen Pfadangaben für die wahlfreien Protokolldateien an. Sehen Sie sich diese Dateien zusätzlich zur Datei \os2\install\wpinstal.log auf dem Boot-Laufwerk an, wenn während der Installation Probleme auftreten.

#### 3.8.2 Installieren des Java-Plug-Ins nach der Installation von IBM Web Browser for OS/2

Wenn Sie IBM Web Browser for OS/2 nach Developer Kit installiert haben und das Java-Plug-In für diesen Browser aktivieren wollen, müssen Sie folgende Schritte ausführen:

1. Suchen Sie die Datei mzplugin.exe. Sie befindet sich im Verzeichnis \JAVA131\ns\ von Runtime Environment. Kopieren Sie die Datei mzplugin.exe in ein temporäres Verzeichnis.
2. Führen Sie die Datei mzplugin.exe in dem Verzeichnis aus, in das Sie diese Datei kopiert haben, indem Sie den Dateinamen an einer Eingabeaufforderung eingeben. Durch die Ausführung der Datei werden folgende Dateien extrahiert:

- insmzplg.cmd: CLIFI-Befehl zur Ausführung der Installation des Java-Plug-Ins
- npoji6.dll: DLL für das Java-Plug-In
- mzcheck2.exe: Benutzer-Exit zur Suche von Netscape
- mzfiles.rsp: Antwortdatei für Feature Install (FI). Editieren Sie diese Datei nicht.
- mzuser.rsp: Teilantwortdatei für Benutzer als Beispiel
- package.ctl: Eine für Feature Install erforderliche Paketdatei

3. Gehen Sie zurück in das Verzeichnis \JAVA131\ns\.
4. Editieren Sie die Datei insmzplg.cmd so, dass sie auf die korrekten Pfade und das korrekte Boot-Laufwerk zeigt.
5. Editieren Sie die Datei mzuser.rsp, um das Java-Plug-In zu aktivieren. Die neueste Version von IBM Web Browser for OS/2 ist aktiviert. (Wenn Sie eine bestimmte Version von IBM Web Browser for OS/2 aktivieren wollen, setzen Sie die Variable JAVAMZFILES.NSDRV in der Datei mzuser.rsp auf das Laufwerk und den vollständig qualifizierten Pfad.)
6. Führen Sie die Datei insmzplg.cmd aus.
7. Starten Sie das System erneut.

Verwenden Sie die folgende Variablenliste beim Setzen der Variablen in den oben genannten Dateien als Referenz.
Dabei gilt Folgendes:

xx | Gibt die Variable für die gewünschte Sprache an.
/r | Gibt den vollständigen Pfad für die Feature Install-Antwortdatei an.
/r2 | Gibt Laufwerk, Pfad und Namen der Benutzerantwortdatei an.
/b | Gibt das Boot-Laufwerk an.
/s | Gibt den vollständigen Pfad für die extrahierten Developer Kit-Dateien an.
/l1 und /l2 | Gibt die vollständigen Pfadangaben für die wahlfreien Protokolldateien an. Sehen Sie sich diese Dateien zusätzlich zur Datei \os2\install\wpinstal.log auf dem Boot-Laufwerk an, wenn während der Installation Probleme auftreten.

#### 3.8.3 Die Java Plug-In-Steuerkonsole

Nach der Installation des Java-Plug-Ins können Sie das Verhalten des Java-Plug-Ins während der Laufzeit einstellen. Bei der Ausführung des Java-Plug-Ins können Sie beispielsweise festlegen, ob die Java-Steuerkonsole beim Starten des Java-Plug-Ins aktiviert werden soll.

Bei der Steuerkonsole handelt es sich um eine Java-Anwendung, die über die Befehlsdatei [x:\JAVA131]\jre\bin\jctrlpnl.cmd gestartet wird. Ein Symbol für diese Befehlsdatei befindet sich im Verzeichnis [x:\JAVA131]. Dabei ist x das Laufwerk, auf dem Developer Kit installiert ist. Standardmäßig ist JAVA131 der Name des Verzeichnisses.

### 3.9 Inaktivieren des JIT-Compilers

Mit Developer Kit wird ein JIT-Compiler (Just-in-Time) zur Verfügung gestellt. Der JIT-Compiler erstellt Maschinencode für häufig verwendete Bytecodesequenzen in einer Java-Anwendung oder einem Java-Applet noch während der Ausführung. Der JIT-Compiler ist standardmäßig aktiviert. Sie können den JIT-Compiler inaktivieren, um beispielsweise Probleme mit einer Java-Anwendung, einem Java-Applet oder dem Compiler selbst einzugrenzen. Übergeben Sie zum Inaktivieren des Compilers folgenden Befehl an den Java Laufzeitinterpreter:

    SET JAVA_COMPILER=none

### 3.10 Ändern von Dateinamen

Es gibt einige kurze Dateinamen gemäß der für OS/2 gültigen Dateinamenkonvention 8.3, die von den für Plattformen wie Microsoft(R) Windows(R) und Linux erforderlichen langen Dateinamen abweichen. Dazu gehören bekanntermaßen folgende Dateinamen:

Lange Dateinamen | Kurze OS/2-Dateinamen
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
Bekannte Abweichungen bei Dateinamen, die sich durch die Verwendung von kurzen Dateinamen gemäß der für OS/2 gültigen Dateinamenkonvention 8.3 ergeben.

### 3.11 Konfigurieren der Appletansicht

Gehen Sie wie folgt vor, um die Appletansicht für eine Internetverbindung über ein Proxy-Gateway zu konfigurieren:

1. Klicken Sie die Appleteigenschaften an.
2. Klicken Sie den Eintrag Eigenschaften an.
3. Geben Sie in den entsprechenden Feldern den Namen des Proxy-Servers und den verwendeten Anschluss an.
Beispiel:

         Http-Proxy-Server: myproxy.mycompany.com
         Http-Proxy-Port:   80

Ist Ihr Web-Browser bereits für eine Verbindung zum Internet konfiguriert, übernehmen Sie die für diese Konfiguration definierten Werte. Verwenden Sie beispielsweise für WebExplorer(R) die auf der Seite für die Serverkonfiguration verwendeten Werte für das Proxy-Gateway, verzichten Sie dabei jedoch auf die Angabe 'http://' am Anfang und den Schrägstrich '/' am Ende der Adresse.
Erkundigen Sie sich bei Ihrem Systemadministrator, ob Sie zur Verwendung der Proxy-Services berechtigt sind, wenn Ihnen der Name des Proxy-Gateways nicht bekannt sein sollte.
4. Klicken Sie den Knopf Anwenden an, um die Änderungen zu speichern.
5. Schließen Sie die Appletansicht.

### 3.12 Angeben der Optionen und der Systemmerkmale für Java

Sie können Optionen und Systemmerkmale für Java angeben, indem Sie eine Umgebungsvariable mit der Bezeichnung IBM_JAVA_OPTIONS erstellen und die gewünschten Werte definieren. Allen Optionen und Systemmerkmalen für Java, die erste Option ausgenommen, muss ein Leerzeichen vorangestellt sein. Sie können die Umgebungsvariable IBM_JAVA_OPTIONS beispielsweise folgendermaßen definieren:

    IBM_JAVA_OPTIONS=-Dmysysprop1=tcpip -Dmysysprop2=wait

Wenn Sie dieselben Optionen bzw. Merkmale über die Befehlszeile (oder ein JNI-Programm) angeben, setzen diese Werte die über die Umgebungsvariable IBM_JAVA_OPTIONS angegebenen Optionen und Merkmale außer Kraft. Einzige Ausnahme: Bei Angabe von -Xt, -Xtm oder -Xdebug gilt dies nicht. Diese Werte implizieren, dass kein JIT verwendet werden soll.

Beachten Sie bitte Folgendes:

- Die Umgebungsvariable IBM_JAVA_OPTIONS hat bei Verwendung mit JNI_VERSION_1_1 keine Auswirkung.
- Java-Optionen sollten in ihrem aktuellen Format angegeben werden: beispielsweise -verbose:gc anstelle von -verbosegc.

Das Systemmerkmal ibm.jvm.bootclasspath ermöglicht die Definition eines zusätzlichen Suchpfads. Der Wert dieses Merkmals wird zwischen über -Xbootclasspath/p: definierten Werten und dem Boot-Klassenpfad eingefügt. Der Boot-Klassenpfad ist entweder der Standardpfad oder der durch die Option -Xbootclasspath: definierte Pfad. Weitere Informationen zu diesen Optionen finden Sie im Abschnitt 3.1 Weitere Informationsquellen.

### 3.13 RMI über IIOP

Java-RMI (Remote Method Invocation) stellt eine einfache Methode für verteilte Java-Programmierung bereit. RMI-IIOP erweitert Basis-Java-RMI mit der Datenübertragung über das Standardprotokoll IIOP (Internet Inter-ORB Protocol) der CORBA-Architektur. Dies ermöglicht eine direkte Interaktion mit beliebigen anderen CORBA-ORBs (Object Request Broker), unabhängig davon, ob diese in Java oder einer anderen Programmiersprache implementiert sind.

Developer Kit beinhaltet eine Unterstützung für Anwendungen, die für die Verwendung von RMI-IIOP (RMI nach IIOP) entwickelt wurden. Diese Unterstützung ist Bestandteil der Standardinstallation von Runtime Environment und erfordert keine spezielle Konfiguration.

#### 3.13.1 Der Compiler von IDL nach Java

Das vorliegende Release beinhaltet einen Compiler, der CORBA IDL (Interface Definition Language - Schnittstellendefinitionssprache) nach Java übersetzt. Weitere Informationen hierzu können Sie dem Benutzerhandbuch zu diesem Compiler entnehmen. Die Dokumentation befindet sich in folgendem Verzeichnis:

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

Dabei ist [x:\JAVA131] das Laufwerk und das Verzeichnis, in dem Developer Kit installiert ist. Standardmäßig ist JAVA131 der Name des Verzeichnisses.

Der Compiler von IDL nach Java unterstützt die CORBA-Spezifikation 2.3. Dazu gehört das Konstrukt "valuetype" und die Zuordnung dieses Konstrukts von IDL in Java. Einzelheiten zu dieser Unterstützungsfunktion finden Sie auf folgenden FTP-Sites:

- ftp://ftp.omg.org/
  Klicken Sie auf dieser Hauptseite Folgendes an: pub --> docs --> formal --> 99-07-53.pdf
  (Zuordnung von IDL in Java)
- ftp://ftp.omg.org/
  Klicken Sie auf dieser Hauptseite Folgendes an: pub --> docs --> formal --> 98-12-01.pdf
  (CORBA 2.3 Core)

Der Compiler von IDL nach Java wird bereitgestellt, damit Sie mit der durch den Befehl "rmic -idl" generierten IDL experimentieren können. Diese generierte IDL und der Compiler von IDL nach Java sind nicht erforderlich, wenn RMI-IIOP für Java nach Java verwendet wird. Mit Hilfe der generierten IDL kann RMI-IIOP gemeinsam mit anderen Sprachen wie C++ verwendet werden. Zur gemeinsamen Verwendung mit C++ muss die generierte IDL mit einem Compiler von IDL nach C++ kompiliert werden, der die CORBA 2.3-Spezifikation unterstützt.

##### 3.13.1.1 Einschränkungen des Compilers von IDL nach Java

Berücksichtigen Sie bei der Verwendung des Compilers von IDL nach Java folgende Überlegungen:

- Mit Escape-Zeichen versehene Kennungen im Globalbereich haben möglicherweise eine andere Schreibweise als die IDL-Basiselementtypen Object oder ValueBase. Dies liegt daran, dass die Symboltabelle mit diesen Kennungen vorgeladen ist. Eine Neudefinition würde ihre ursprünglichen Definitionen überschreiben.
- Beim lokalen Übergeben gibt es keine lokalen Stubs und keine Kopiersemantik.
- Der feste IDL-Typ wird nicht unterstützt.
- Die generierten Stubs unterstützen serielle Anordnung nicht. Dies liegt daran, dass die IDL- und Java-Zuordnungsspezifikation vom 22.8.1998 (Abschnitt 25.3.1.3) die erforderlichen Angaben nicht enthält.
- Konstanten des Typs "octet" können nicht deklariert werden.

##### 3.13.1.2 Bekannte Probleme des Compilers von IDL nach Java

Folgende Probleme des Compilers von IDL nach Java sind bekannt:

- Der Compiler beendet die Kompilierung ohne Fehler, generiert jedoch keine Ausgabe. Geben Sie in diesem Fall die Option -emitAll an, um die Generierung aller Klassen zu erzwingen. Wenn Sie die Option -emitAll verwenden, empfiehlt es sich, die Option -pkgPrefix ebenfalls zu verwenden, mit der allen Klassennamen, die mit 'java' beginnen, ein Präfix hinzugefügt wird. Dadurch werden Namensunverträglichkeiten mit Klassen in der JVM vermieden.
- Der Compiler erkennt den veralteten Typ CORBA::Principal nicht.
- Die Deklaration einer Konstanten und einer Methode oder eines Attributs in demselben Bereich und mit demselben Namen führt nicht zu einem Fehler. Die folgende IDL kann zu einem Fehler führen:

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

- Die folgende IDL führt in Schnittstelle B zu einem Fehler, der angibt, dass S kein deklarierter Typ ist. Dies darf jedoch nicht der Fall sein.

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

- Wenn eine Datentypvariable eine andere Datentypvariable in ihrer Standardklausel definiert, führt die Kompilierung der Java-Ergebnisklasse zu Fehlern. Die Lösung dieses Problems besteht in der Definition der verschachtelten Datentypvariablen außerhalb der eingeschlossenen Datentypvariablen.

#### 3.13.2 Weitere Informationen

Weitere Informationen zu IBM und RMI-IIOP finden Sie auf der folgenden IBM Website:
http://www.ibm.com/java/jdk/rmi-iiop/index.html

Weitere verfügbare Dokumentation:

- Developer Kit-README (Informationsdatei) befindet sich in dem Verzeichnis, in dem Sie Developer Kit installiert haben.
- Das Handbuch RMI-IIOP Programmer's Guide enthält eine Einführung zum Verfassen von RMI-IIOP-Programmen. Es befindet sich auf folgender Website bzw. im folgenden Verzeichnis/in folgender Datei:

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

- Im Handbuch IDL-to-Java Compiler User's Guide wird die Verwendung des Tools beschrieben, mit dem Java-Code von IDL generiert wird. Es befindet sich auf folgender Website bzw. im folgenden Verzeichnis/in folgender Datei:
  - http://www.ibm.com/java/jdk/rmi-iiop/docs/win130/toJavaPortableUG.htm
  - [x:\JAVA131]\DOCS\RMI-IIOP\toJavaPortableUG.htm
- Folgende Beispielverzeichnisse sind vorhanden:
  - Ein Beispiel Hello World, das zwischen dem JRMP- und dem IIOP-Protokoll austauschbar ist ([x:/JAVA131]/rmi-iiop/samples/Hello)
  - Ein Beispiel Hello World, das gemeinsam mit einem IDL-Standardprogramm verwendet wird ([x:/JAVA131]/rmi-iiop/samples/idl)

  Dabei ist [x:\JAVA131] das Laufwerk und das Verzeichnis, in dem Developer Kit installiert ist. Standardmäßig ist JAVA131 der Name des Verzeichnisses.

- Das Dokument Java Language to IDL Mapping enthält eine genaue technische Spezifikation von RMI-IIOP. Es befindet sich auf folgender Website:
  ftp://ftp.omg.org/
  Klicken Sie auf dieser Hauptseite Folgendes an: pub --> docs --> formal --> 99-07-59.pdf
- Die Java-API-Informationen von Sun Microsystems befinden sich auf folgender Website: http://java.sun.com/products/?frontpage-main

#### 3.13.3 RMI-IIOP-Begriffe

API | Application Programming Interface (Anwendungsprogrammierschnittstelle)
CORBA | Common Object Request Broker Architecture (CORBA-Architektur)
IDL | Interface Definition Language (Schnittstellendefinitionssprache)
IIOP | Internet Inter-ORB Protocol (Internet-Inter-ORB-Protokoll)
| ORB | Object Request Broker

RMI | Remote Method Invocation

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

Die Java 2-Plattform bietet ein Mittel zur Zugriffssteuerung, die darauf aufbaut, woher Code kommt und wer ihn verfasst hat. Diese Zugriffssteuerung ist aufgrund des hohen Verteilungsgrades der Java-Plattform notwendig. Beispielsweise kann ein fernes Applet über ein öffentliches Netzwerk heruntergeladen und danach lokal ausgeführt werden.

Die Java 2-Plattform bietet jedoch keine Möglichkeit zu einer ähnlichen Zugriffssteuerung auf der Grundlage, wer den Code ausführt. Für diese Art der Zugriffssteuerung benötigt die Java 2-Sicherheitsarchitektur Folgendes:

- Zusatzunterstützung für Authentifizierung (Bestimmung des Ausführenden des Codes)
- Erweiterungen der vorhandenen Authentifizierungskomponenten zur Umsetzung neuer Zugriffssteuerung auf der Grundlage der authentifizierten Personen

Java Authentication and Authorization Service (JAAS) bietet diese Erweiterungen.

Eine allgemeine Übersicht über JAAS finden Sie auf der folgenden Website:

http://java.sun.com

Klicken Sie auf dieser Hauptseite Products & APIs an und blättern Sie vor bis zum Abschnitt Optional Packages. Die Dokumente auf dieser Website enthalten Verbindungen zu vielen anderen Web-Informationsquellen.

#### 3.14.1 Unterschied zwischen der IBM und der Sun-Version von JAAS

Die IBM Version von JAAS für OS/2 unterscheidet sich von der Sun-Version von JAAS für Windows dadurch, dass die com.sun.*-Pakete in die com.ibm.*-Pakete versetzt wurden.

#### 3.14.2 Basisinstallation

Nachfolgend finden Sie Informationen zur Position der JAAS-Dateien:

- Die Dateien jaas.jar und jaas_lm.jar befinden sich im Unterverzeichnis jre\lib\ext des Verzeichnisses, in dem Sie Runtime Environment installiert haben
.
- JAAS enthält ein einfaches Anmeldemodul (LoginModule), das die aktuellen Anmeldeinformationen des Betriebssystems für Java-Programme verwendet. Zur Bereitstellung dieser Funktion wurden folgende Dateien in den angezeigten Unterverzeichnissen des Installationsverzeichnisses von Runtime Environment installiert:

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

- Im Dokumentationsverzeichnis JAVA131\docs\jaas befindet sich die Dokumentation zur JAAS-API sowie die Datei module.html. Suchen Sie im JAAS-Dokumentationsverzeichnis die Datei JaasDocs.jar (sie enthält die Dokumentation zur JAAS-API), und entpacken Sie sie mit Jar (jar -xvf JaasDocs.jar) auf einer HPFS- oder JFS-Partition. Suchen Sie die Datei index.html. Verwenden Sie einen Browser, um mit Hilfe der Datei index.html auf die übrige API-Dokumentation zuzugreifen.

Hinweis: Runtime Environment ist im Verzeichnis x:\JAVA131 installiert. Dabei ist x das Laufwerk, auf dem Developer Kit installiert ist. Standardmäßig ist JAVA131 der Name des Verzeichnisses.

### 3.15 JNI-Programmierinformationen

Auf Java-Objekte kann von einem C-Programm über die Native Java-Schnittstelle (JNI - Java Native Interface) zugegriffen werden. Diese Funktion wurde in Java 1.1.1 eingeführt. Sie bietet eine stabilere Schnittstelle als die bisherige NMI (Native Method Interface).

JNI-Anwendungen müssen normalerweise aus den folgenden Gründen mit den Java-Typen 'long', 'float' und 'double' interagieren:

- Zum Empfangen der Variablen als Parameter nativer Methoden
- Zum direkten Prüfen oder Ändern der Exemplar- oder Klassenvariablen
- Zum Zurückgeben der Variablen als Rückgabewert nativer Methoden
- Zum Übergeben der Variablen als Parameterdaten beim Aufrufen anderer Java-Methoden von einer nativen Methode aus

### Native JNI-Typen

Für jeden Java-Typ enthält die JNI native Typen, die Sie in Ihrer JNI-Anwendung verwenden können. Diese Typen werden in der nachfolgenden Tabelle angegeben.

Native JNI-Typen
Java-Typ | Nativer JNI-Typ | Größe in Byte
--- | --- | ---
long | jlong | 8
double | jdouble | 8
float | jfloat | 4
Native JNI-Typen

Hinweis: Diese Typen müssen nicht verwendet werden, wenn Ihre Anwendung die Java-Typen long, double und float nicht verarbeitet.

Verwenden Sie die nativen JNI-Typen beim Definieren einer Implementierung einer nativen Methode, so dass der Compiler die Kennung der nativen Methode mit der Kennung in der mit dem Dienstprogramm javah generierten Header-Datei in Übereinstimmung bringt.

### Hilfeprogrammfunktionen und -makros

Die nativen JNI-Typen jlong, jdouble und jfloat sind nicht mit den entsprechenden C- und C++-Typen 'long', 'double' und 'float' kompatibel. Beim Versuch, einen Typ in einen anderen umzusetzen, erhalten Sie entweder Kompilierungsfehler oder unerwartetes Verhalten zur Laufzeit. Versuchen Sie die Konvertierung nicht, da die Formate der nativen JNI-Typen Developer Kit-spezifisch sind.

Die JNI-Header-Datei (jni.h) verweist über eine INCLUDE-Anweisung auf eine weitere Header-Datei (int64_md.h), die im Lieferumfang von Developer Kit enthalten ist. Diese Datei definiert Hilfeprogrammfunktionen und -makros, die Sie zum Arbeiten mit den nativen Typen verwenden können.

Die Funktionen und Makros in der Datei int64_md.h (für den Typ jlong) enthalten normalerweise ll am Anfang oder am Ende des Namens. Die Funktionen für die Typen jdouble oder jfloat enthalten normalerweise dbl, double, flt oder float im Namen. Außerdem sind einige Konstanten für jlong, jdouble und jfloat definiert.

Beispiele für Makros:

- Das Makro ll_add() fügt zwei jlongs hinzu und gibt ein jlong zurück.
- Das Makro int2ll() konvertiert ein int in ein jlong.
- Die Funktion ll2str() konvertiert ein jlong in eine ASCII-Zeichenfolgedarstellung des 64-Bit-Werts.
- Die Funktion flt2dbl() konvertiert ein jfloat und gibt ein jdouble zurück.
- Das Makro dbl2nat() konvertiert ein jdouble in ein natives OS/2-double
.
- Das Makro dbl_sqrt() zieht die Quadratwurzel eines jdouble und gibt ein jdouble zurück.
- Die Funktionen dbl2str() und flt2str() konvertieren deren Argumente in eine ASCII-Zeichenfolgedarstellung.

### 3.16 Überlegungen zur Systemleistung

Möglicherweise benötigen einige Anwendung unter Version 1.3.1 von OS/2 Warp Development Kit, Java 2 Technology Edition, mehr Zeit zum Laden als unter Version 1.3.0. In diesem Fall empfiehlt es sich, den Befehlszeilenparameter -Xquickstart für JAVA.EXE zu verwenden.

Der JIT-Compiler für OS/2 Java 1.3.1 nimmt standardmäßig einige zusätzliche Optimierungen vor, die die zum Laden von Anwendungen erforderliche Zeit unter Umständen erhöhen. Die zusätzlichen Optimierungen sollen eine Verbesserung der Laufzeitleistung der jeweiligen Anwendung bewirken. Die Auswirkungen der Optimierungen auf Laufzeitleistung und Ladezeit variieren bei den einzelnen Anwendungen. Bei einigen Anwendungen werden sich keine oder nur sehr geringfügige Änderungen gegenüber Java 1.3.0 bemerkbar machen. Der Parameter -Xquickstart bewirkt die Verwendung einer weniger komplexen Gruppe von Optimierungen und kann so möglicherweise zu einer kürzeren Startzeit führen. Die Unterschiede in der Leistung bei einem Start mit und einem Start ohne -Xquickstart variieren bei den einzelnen Anwendungen.

## 4.0 WEITERE SCHRIFTARTPAKETE

Wenn Sie ein oder mehrere Schriftartpakete in einer Datei heruntergeladen haben, gehen Sie zum Abschnitt Installieren weiterer Schriftarten, um Installationsanweisungen zu erhalten. Wenn Sie Teildateien heruntergeladen haben, führen Sie folgende Schritte aus, um die Teildateien zu einer installierbaren Datei zu verknüpfen. Fahren Sie danach mit den Abschnitten zur Installation fort.

1. Stellen Sie sicher, dass sich alle Teildateien der gewünschten Schriftart in demselben Verzeichnis befinden.
2. Verknüpfen Sie die Dateien an einer Eingabeaufforderung in dem Verzeichnis, in das Sie die Teildateien geladen haben, mit dem Kopierbefehl. Sie müssen die Namen der Teildateien und den Dateinamen der ganzen Schriftart angeben. Wenn Sie z. B. drei Teildateien heruntergeladen haben, müssen Sie Folgendes eingeben:

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

Dabei gilt Folgendes:

ExamFont.txx | Steht für den Namen der heruntergeladenen Teildatei. (Dabei ist xx die Nummer der heruntergeladenen Teildatei.) Die Teildateien müssen in der richtigen Reihenfolge angegeben werden.
ExamFont.ttf | Steht für den vollständigen Namen der Schriftart.

### 4.1 Installieren zusätzlicher Schriftarten

In den folgenden Abschnitten finden Sie Installationsinformationen zur CID-Installation oder zur Installation über die Schriftartpalette.

#### 4.1.1 CID-Installation

Führen Sie folgende Schritte aus, um über eine CID-Installation weitere Schriftarten zu installieren:

1. Suchen Sie die Datei wtfont.exe, die sich im Verzeichnis x:\JAVA131\fonti von Developer Kit befindet. x ist das Laufwerk, auf dem Developer Kit installiert ist.
2. Führen Sie die Datei wtfont.exe aus, indem Sie den Dateinamen an einer Eingabeaufforderung eingeben. Durch die Ausführung der Datei werden folgende Dateien extrahiert:

- wtfnt.cmd: Eine Befehlsdatei, die CLIFI ausführt
- wtfonts.rsp: Antwortdatei für Feature Install (FI). Editieren Sie diese Datei nicht.
- wtfntusr.rsp: Eine Benutzerantwortdatei. Editieren Sie diese Datei, um auszuwählen, welche Schriftarten Sie installieren wollen.
- PACKAGE.CTL: Eine für Feature Install erforderliche Paketdatei.

3. Kopieren Sie die Datei PACKAGE.CTL in das Verzeichnis, in das Sie die zusätzlichen Schriftartpakete heruntergeladen haben.
4. Editieren Sie die Datei wtfnt.cmd so, dass sie auf die korrekten Pfade und das korrekte Boot-Laufwerk zeigt. Weiter unten finden Sie eine Parameterliste.
5. Editieren Sie die Datei wtfntusr.rsp, um auszuwählen, welche Schriftarten Sie installieren wollen.
6. Führen Sie die Datei wtfnt.cmd aus.
7. Starten Sie das System erneut.

Hinweis: Wenn CLIFI Sie zum Einlegen des Datenträgers auffordert, müssen Sie entweder den Parameter /s: in der Datei wtfnt.cmd korrekt setzen oder die Datei in dasselbe Verzeichnis versetzen wie die Schriftartpakete, die Sie installieren wollen.

Verwenden Sie die folgende Variablenliste beim Setzen der Variablen in den oben genannten Dateien als Referenz.

Dabei gilt Folgendes:

/s: | Gibt die Quelle der Schriftartpakete und der Datei PACKAGE.CTL an.
/b: | Gibt das Boot-Laufwerk an.
/r2: | Gibt Laufwerk, Pfad und Namen der Benutzerantwortdatei an.
/r: | Gibt die Feature Install-Datei an (wtfntusr.rsp).
/l1 und /l2 | Gibt die vollständigen Pfadangaben für die wahlfreien Protokolldateien an. Sehen Sie sich diese Dateien zusätzlich zur Datei \os2\install\wpinstal.log auf dem Boot-Laufwerk an, wenn während der Installation Probleme auftreten.

#### 4.1.2 Über die Schriftartpalette

Führen Sie folgende Schritte aus, um über die Schriftartpalette weitere Schriftarten zu installieren:

1. Öffnen Sie den OS/2-Ordner System.
2. Klicken Sie den Ordner Systemkonfiguration an.
3. Klicken Sie Schriftartpalette an.
4. Klicken Sie Schriftart editieren an.
5. Klicken Sie den Knopf Hinzufügen an.
6. Geben Sie das Laufwerk und das Verzeichnis ein, auf/in das Sie die Schriftartdateien heruntergeladen haben.
7. Wählen Sie die Schriftart aus, die installiert werden soll, und klicken Sie Hinzufügen an.

## 5.0 DOUBLE-BYTE CHARACTER SET INFORMATION

The following sections describe known double-byte character set (DBCS) considerations.

### 5.1 Installation panel text missing or too long in DBCS countries or regions

When installing the Developer Kit on DBCS versions of OS/2, DBCS characters might not be displayed on the installation panels or the lines could exceed the right border of the display window, even when the window is maximized.

To correct these problems, exit the installation program, open the Netscape Navigator or Netscape Communicator for OS/2 object, and click the Options menu item. Open the General Preferences notebook and select the Fonts tab. Choose the proper encoding for your country or region and then set the proportional and fixed fonts to MINCHO. Click OK to save the changes. When you start the installation of the Developer Kit again, the text should be displayed correctly.

### 5.2 TrueType fonts must be installed on Chinese systems

On Simplified or Traditional Chinese systems, ensure that all available OS/2 TrueType fonts are installed. To install these fonts, do the following:

1. At an OS/2 command prompt and where C: is the boot drive, start the Selective Install program by typing:

            C:\OS2\INSTALL\INSTALL

   A panel titled "System Configuration" is displayed.
2. Continue to the OS/2 Setup and Installation panel by clicking the Next button (for OS/2 Warp 4.0) or the OK button (for OS/2 Warp Server for e-business)).
3. On the OS/2 Setup and Installation panel, select the TrueType Fonts check box.
4. Click the More button to the right of this check box.
5. Make sure all font check boxes are selected. Click OK.
6. Insert the operating system CD-ROM (OS/2 Warp Server 4.0 or OS/2 Warp Server for e-business) into the CD drive.
7. Click OK on the Source Directory panel.

The appropriate fonts should be installed. Restart your system when the font installation is completed.

### 5.3 Program temporary fixes and FixPaks for DBCS systems

Some DBCS users might encounter the following behaviors relating to Asian Input Method operation. Many of these items are addressed in the latest releases of the operating system. However, if you are unable to upgrade to a later release, contact your local IBM Service Representative about the availability of any applicable Program Temporary Fixes (PTFs) or FixPaks.

The following table describes behaviors relating to Asian Input Method operation and the DBCS system affected.

Description | DBCS System Affected
--- | ---
When focus is moved to other frame, Trap occurs in IME. | Traditional Chinese
When focus is moved to other frame at displaying lookup window, conversion operation does not work correctly. | Traditional Chinese
When focus is moved to other frame at displaying lookup window, lookup window does not disappear. | Japanese
The correct input mode is not displayed at input mode indicator. | Japanese, Simplified Chinese, Traditional Chinese
A conversion string at active client does not disappear by pressing ESC key. | Traditional Chinese
When user switches to JAVA native IME, a conversion key does not work correctly. | Japanese, Simplified Chinese, Traditional Chinese
System goes down when opening too many IM frames. | Traditional Chinese
Cannot continue the input if switching back to English input mode without selecting any DBCS characters from the lookup window. | Simplified Chinese, Traditional Chinese
A conversion string at the active client does not disappear by pressing Ctrl+Space key. | Simplified Chinese
Pressing the Backspace key when displaying the lookup window causes a trap to occur in IME. | Simplified Chinese
Descriptions of behaviors relating to Asian Input Method operation and the DBCS system affected.

### 5.4 Controlling Arabic number character display

Users in some countries or regions could unexpectedly see Arabic number characters appear. Some country- or region-specific versions of OS/2 map the characters x'00B0' through x'00B9' to the Arabic numbers zero (0) through nine (9). To see the desired characters, change the Bi-directional Attributes in CONFIG.SYS or use the Language page in the Properties notebook (Settings notebook in OS/2 Warp Server for e-business) of the object to obtain the desired effect.

### 5.5 Japanese environment settings on OS/2 Warp 4 Japanese version

Use the following Japanese environment settings for OS/2 Warp 4 Japanese version:

Codepage: | 932
ShiftJIS code: | New JIS

### 5.6 Required fonts on OS/2 Warp Japanese version

To run the Developer Kit, the following fonts are required on your system:

Name | Style
GOTHIC | Normal
GOTHIC | HeiseiKakuGothic-W5-H-90-TT
MINCHO | HeiseiMincho-W3-H-90-TT
Required fonts on OS/2 Warp Japanese version.

You can check them in the Font Palette, which is in the System Setup folder in the OS/2 System folder.

- GOTHIC Normal font is included in GOTHIC system Japanese font.
- GOTHIC HeiseiKakuGothic-W5-H-90-TT is IBM HeiseiKakuGothic TrueType font with New JIS order.
- MINCHO HeiseiMincho-W3-H-90-TT is IBM HeiseiMincho TrueType font with New JIS order.

These fonts can be installed through the Selective Install program object, which is in the Install/Remove folder in the System Setup folder on OS/2 Warp 4 systems and OS/2 Warp Servers for e-business.

### 5.7 Improving font quality on OS/2 Warp Server for e-business

On OS/2 Warp Server for e-business, you can improve the font quality of a small point size font by enabling an association between an outline font and a bitmap font. To enable the association, do the following:

1. Open the OS/2 System folder.
2. Open the System Setup folder.
3. Open the System object.
4. Open the Associate to Bitmap Font page.
5. Check the Enable button.
6. Double-click the system menu icon to close the System object.

If you would like more information on bitmap font association, click the help button located on the Associate to Bitmap Font page.

## 6.0 DEINSTALLIEREN VON DEVELOPER KIT

In den folgenden Abschnitten finden Sie Informationen zum Deinstallieren von Developer Kit.

Wenn Sie Komponenten von Developer Kit mehrmals installiert haben, ohne diese Komponenten zuvor zu deinstallieren, enthält die Datei CONFIG.SYS weiterhin Verweise auf JAVA131. Wenn Sie diese Verweise entfernen wollen, löschen Sie sie aus der Datei CONFIG.SYS.

Hinweis: Wenn Netscape Communicator während der Deinstallation von Developer Kit aktiv ist, schlägt die Deinstallation fehl. Sie müssen Netscape Communicator schließen, bevor Sie den Deinstallationsprozess starten.

### 6.1 Über den Desktop

Gehen Sie wie folgt vor, um die Installation mit dem Objekt "Developer Kit entfernen" zu entfernen:

1. Öffnen Sie den OS/2-Ordner System.
2. Öffnen Sie den Ordner Systemkonfiguration.
3. Öffnen Sie den Ordner Selektives Löschen. Unter OS/2 Warp 4 öffnen Sie den Ordner Installieren/Entfernen und dann den Ordner Selektives Löschen.
4. Klicken Sie das Objekt Developer Kit für OS/2 entfernen doppelt an, um das Deinstallationsprogramm zu starten.

Wenn Sie weitere Schriftartdateien oder Plug-In-Dateien von Java, wie die Datei plugin.exe oder mzplugin.exe, extrahiert haben und diese aus Ihrem System entfernen wollen, gehen Sie zu dem Laufwerk und Verzeichnis, auf/in dem Sie sie installiert haben, und löschen Sie sie.

### 6.2 Über eine OS/2-Eingabeaufforderung

Stellen Sie vor dem Entfernen der Installation sicher, dass Sie sich im Stammverzeichnis des Laufwerks befinden, auf dem Runtime Environment installiert ist. Geben Sie in einer OS/2-Befehlszeile Folgendes ein:

         JAVA131/UNINSTAL/UNINSTAL

Das Deinstallationsprogramm führt Sie durch die einzelnen Schritte. Nur Dateien und Verzeichnisse, die mit dem Installationsprozess erstellt wurden, werden entfernt. Das Verzeichnis HOTJAVA, das beim Ausführen von Applet-Ansicht erstellt wird, wird z. B. nicht entfernt.

Wenn Sie weitere Schriftartdateien oder Plug-In-Dateien von Java, wie die Datei plugin.exe oder mzplugin.exe, extrahiert haben und diese aus Ihrem System entfernen wollen, gehen Sie zu dem Laufwerk und Verzeichnis, auf/in dem Sie sie installiert haben, und löschen Sie sie.

### 6.3 Deinstallieren von Developer Kit unter WorkSpace On-Demand 2.0

Sie müssen auf das Objekt 'Java 1.3' im Verzeichnis der installierten Einrichtungen (\os2\install\Installierte Einrichtungen) zugreifen können, um die Installation von Developer Kit entfernen zu können. Wenn Sie Developer Kit sowohl für den WorkSpace On-Demand 2.0-Client als auch zur Verwendung auf dem WorkSpace On-Demand 2.0-Server installieren, wird das Inventarobjekt für Java 1.3 beschädigt oder ersetzt. Entfernen Sie daher mit dem Deinstallationsprogramm keine Developer Kit-Komponenten aus dem Client-Speicherbereich.

Löschen Sie stattdessen die Verzeichnisstruktur [rpl-laufwerk]\ibmlan\rpl\bb20.xx\JAVA131 und alle Verweise auf dieses Verzeichnis, die den Imageverzeichnissen des WorkSpace On-Demand-Clients hinzugefügt wurden (beispielsweise die Dateien CONFIG.SYS, OS2.INI und FIT).

Löschen Sie das Verzeichnis \JAVA131 inklusive der darin enthaltenen Unterverzeichnisse, um Developer Kit vom Server zu entfernen. Sie können die komplette Verzeichnisstruktur über das Objekt Laufwerke im OS/2-Ordner System löschen.

### 6.4 Nicht überwachtes Deinstallieren

Geben Sie den folgenden einzeiligen Befehl in einer OS/2-Befehlszeile ein, um Developer Kit zu deinstallieren:

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

### 6.5 Entfernen von Developer Kit als Standard-JVM

Zum Entfernen und Ersetzen von Developer Kit als Standard-JVM müssen Sie die Anweisung x:\JAVA131\JRE\BIN; aus der Anweisung PATH Ihrer Datei CONFIG.SYS entfernen. Starten Sie das System neu, damit die Änderung wirksam wird.

## 7.0 BEKANNTE EINSCHRÄNKUNGEN

- Es gibt bekannte Anwendungen, die bei der Installation von Developer Kit als Standard-JVM fehlschlagen. Dies umfasst folgende Anwendungen:
  - LVMGUI: Die grafische Benutzerschnittstelle für Logical Volume Manager
  - Bestimmte Komponenten von TCP/IP

- Developer Kit kann nicht in eine Datei schreiben oder von ihr lesen, deren Größe 2 Gigabyte übersteigt.

- Wenn Sie JCE-Sicherheitserweiterungen (Java Cryptography Extensions) herunterladen und installieren, müssen Sie die JCA-Datei jre/lib/ext/ibmjca.jar während des Installationsvorgangs löschen. Da die JCA-Funktionalität Bestandteil von JCE ist, können bei Developer Kit Probleme auftreten, wenn beide Komponenten installiert sind.

- Die JDBC-ODBC-Brücke (Java Database Connectivity-Open Database Connectivity Bridge) wird nicht unterstützt.

- Das Java-Plug-In unterstützt in diesem Release von Developer Kit das Drucken nicht.

- Einige Anwendungen sind möglicherweise fest codiert und suchen die ausführbaren Developer Kit-Dateien im Verzeichnis JAVA131\bin. Diese ausführbaren Dateien befinden sich aber im Verzeichnis x:\JAVA131\jre\bin\. Wenn Sie eine dieser Anwendungen verwenden, geben Sie Folgendes an einer Eingabeaufforderung ein, um die ausführbaren Dateien in das Verzeichnis JAVA131\bin zu kopieren:

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

  Dabei ist x das Laufwerk, auf dem Developer Kit installiert ist. Standardmäßig ist JAVA131 der Name des Verzeichnisses.

  Wenn Sie eine Servicestufe auf Developer Kit anwenden, wiederholen Sie den oben genannten Schritt nach der Anwendung der Servicestufe.

- Wenn Sie das IBM Java-Plug-In verwenden, müssen Sie Applets die zum Abschluss des Ladevorgangs erforderliche Zeit unbedingt einräumen, um Browser-Blockierungen zu vermeiden. Klicken Sie beispielsweise den Knopf Zurück und anschließend den Knopf Vor an, während ein Applet geladen wird, können die HTML-Seiten möglicherweise nicht geladen werden.

- Obwohl das IBM Java-Plug-In dieselbe Ebene der LiveConnect-Funktionalität unterstützt, wie sie bei den aktuellen Versionen des Java-Plug-Ins von Sun Microsystems (1.3.0_01) verfügbar ist, treten bekanntermaßen bei beiden Plug-Ins einige LiveConnect-Störungen auf. Sollten Sie Fehler bei LiveConnect melden, geben Sie bei Ihrer Meldung bitte an, ob die Fehler bei der Sun-Version oder der IBM Version des Plug-Ins auftreten.

- Die maximale Größe des HPFS-Platten-Caches beträgt zwei Megabyte. Diese maximale Größe kann die Leistung von Developer Kit unter Umständen einschränken. In vielen Umgebungen können die Systemleistung und die Anwendungsladezeit durch die Verwendung eines größeren Caches verbessert werden. Zu den möglichen alternativen OS/2-Dateisystemen, die einen größeren Cache unterstützen, gehören:

  - JFS, das in IBM OS/2 Warp Server for e-business enthalten ist
  - HPFS 386, das in IBM OS/2 Warp Server Advanced enthalten ist
- Wenn auf einer Maschine mit Pentium(R) MMX (oder einer älteren Version) beim Blättern oder Verschieben des Anzeigebereichs Fehler bei der Farbdarstellung auftreten sollten, können Sie diese Fehler umgehen, indem Sie die Umgebungsvariable JAVA_COMPILER=NONE angeben.

## 8.0 BEMERKUNGEN

(c) Copyright International Business Machines Corporation 1999, 2002. All rights reserved.
(c) Copyright IBM Deutschland GmbH 1999, 2002. Alle Rechte vorbehalten.

Informationen über die gegenwärtig im jeweiligen Land verfügbaren Produkte und Services sind beim IBM Ansprechpartner erhältlich. Hinweise auf IBM Lizenzprogramme oder andere IBM Produkte bedeuten nicht, dass nur Programme, Produkte oder Dienstleistungen von IBM verwendet werden können. Anstelle der IBM Produkte, Programme oder Dienstleistungen können auch andere ihnen äquivalente Produkte, Programme oder Dienstleistungen verwendet werden, solange diese keine gewerblichen Schutzrechte der IBM verletzen. Die Verantwortung für den Betrieb von Fremdprodukten, Fremdprogrammen und Fremdservices liegt beim Kunden.

Für in diesem Handbuch beschriebene Erzeugnisse und Verfahren kann es IBM Patente oder Patentanmeldungen geben. Mit der Auslieferung dieses Handbuchs ist keine Lizenzierung dieser Patente verbunden. Lizenzanfragen sind schriftlich an IBM Europe, Director of Licensing, 92 La Defense Cedex, France, zu richten. Anfragen an obige Adresse müssen auf Englisch formuliert werden.

Trotz sorgfältiger Bearbeitung können technische Ungenauigkeiten oder Druckfehler in dieser Veröffentlichung nicht ausgeschlossen werden. IBM kann jederzeit ohne Vorankündigung Verbesserungen und/oder Änderungen an den in dieser Veröffentlichung beschriebenen Produkten und/oder Programmen vornehmen.

Verweise in dieser Veröffentlichung auf Websites anderer Anbieter dienen lediglich als Benutzerinformationen und stellen keinerlei Billigung des Inhalts dieser Websites dar. Das über diese Websites verfügbare Material ist nicht Bestandteil des Materials für dieses IBM Produkt. Die Verwendung dieser Websites geschieht auf eigene Verantwortung.

Werden an IBM Informationen eingesandt, können diese beliebig verwendet werden, ohne dass eine Verpflichtung gegenüber dem Einsender entsteht.

Lizenznehmer des Programms, die Informationen zu diesem Produkt wünschen mit der Zielsetzung: (i) den Austausch von Informationen zwischen unabhängigen, erstellten Programmen und anderen Programmen (einschließlich des vorliegenden Programms) sowie (ii) die gemeinsame Nutzung der ausgetauschten Informationen zu ermöglichen, wenden sich an folgende Adresse:

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

Die Bereitstellung dieser Informationen kann unter Umständen von bestimmten Bedingungen - in einigen Fällen auch von der Zahlung einer Gebühr - abhängig sein.

Die Lieferung des in der Informationsdatei aufgeführten Lizenzprogramms sowie des zugehörigen Lizenzmaterials erfolgt im Rahmen der Allgemeinen Geschäftsbedingungen der IBM oder einer äquivalenten Vereinbarung.

Alle in diesem Dokument enthaltenen Leistungsdaten stammen aus einer gesteuerten Umgebung. Die Ergebnisse, die in anderen Betriebsumgebungen erzielt werden, können daher erheblich von den hier erzielten Ergebnissen abweichen. Einige Daten stammen möglicherweise von Systemen, deren Entwicklung noch nicht abgeschlossen ist. Eine Garantie, dass diese Daten auch in allgemein verfügbaren Systemen erzielt werden, kann nicht gegeben werden. Darüber hinaus wurden einige Daten unter Umständen durch Extrapolation berechnet. Die tatsächlichen Ergebnisse können abweichen. Benutzer dieses Dokuments sollten die entsprechenden Daten in ihrer spezifischen Umgebung prüfen. Diese Daten stellen deshalb keine Leistungsgarantie dar.

Informationen über Produkte anderer Hersteller als IBM wurden von den Herstellern dieser Produkte zur Verfügung gestellt, bzw. aus von ihnen veröffentlichten Ankündigungen oder anderen öffentlich zugänglichen Quellen entnommen. IBM hat diese Produkte nicht getestet und übernimmt im Hinblick auf Produkte anderer Hersteller keine Verantwortung für einwandfreie Funktion, Kompatibilität oder andere Ansprüche. Fragen zu den Leistungsmerkmalen von Produkten anderer Anbieter sind an den jeweiligen Anbieter zu richten.

Die oben genannten Erklärungen bezüglich der Produktstrategien und Absichtserklärungen von IBM stellen die gegenwärtige Absicht der IBM dar, unterliegen Änderungen oder können zurückgenommen werden, und repräsentieren nur die Ziele der IBM.

COPYRIGHT-LIZENZ:

Diese Veröffentlichung enthält Beispielanwendungsprogramme, die in Quellensprache geschrieben sind. Sie dürfen diese Beispielprogramme kostenlos kopieren, ändern und verteilen, wenn dies zu dem Zweck geschieht, Anwendungsprogramme zu entwickeln, verwenden, vermarkten oder zu verteilen, die mit der Anwendungsprogrammierschnittstelle konform sind, für die diese Beispielprogramme geschrieben werden.

Die in diesem Handbuch aufgeführten Beispiele sollen lediglich der Veranschaulichung und zu keinem anderen Zweck dienen. Sie dürfen diese Beispielprogramme kostenlos kopieren, ändern und verteilen, wenn dies zu dem Zweck geschieht, Anwendungsprogramme zu entwickeln, verwenden, vermarkten oder zu verteilen, die mit den Anwendungsprogrammierschnittstellen von IBM konform sind.

Diese Informationsdatei gilt für IBM OS/2 Warp Developer Kit, Java(TM) 2 Technology Edition, Version 1.3.1, und alle folgenden Releases und Änderungen, bis zur Herausgabe neuer Dateiversionen.

Diese Software basiert zum Teil auf der Arbeit von Free Type Project. Weitere Informationen zu Free Type Project finden Sie unter der Internet-Adresse: http://www.freetype.org

## 9.0 Änderungen in der IBM Terminologie

Die ständige Weiterentwicklung der deutschen Sprache nimmt auch Einfluss auf die IBM Terminologie. Durch die daraus resultierende Umstellung der IBM Terminologie kann es u. U. vorkommen, dass in diesem Handbuch sowohl alte als auch neue Termini gleichbedeutend verwendet werden. Dies ist der Fall, wenn auf ältere existierende Handbuchausschnitte und/oder Programmteile zurückgegriffen wird.

## 10.0 MARKEN

Folgende Namen sind in gewissen Ländern Marken der International Business Machines Corporation:

IBM
OS/2
OS/2 Warp
NetView
WebExplorer

Java und alle auf Java basierenden Marken und Logos sind in gewissen Ländern Marken oder registrierte Marken der Sun Microsystems Inc.

Microsoft und Windows NT sind in gewissen Ländern Marken der Microsoft Corporation.

Intel und Pentium sind in gewissen Ländern eingetragene Marken der Intel Corporation.

Andere Namen von Unternehmen, Produkten oder Dienstleistungen können Marken anderer Unternehmen sein.

[ENDE DES INSTALLATIONS- UND KONFIGURATIONSHANDBUCHS]