### Laufzeitumgebung für

#### IBM(R) OS/2(R) Warp Developer Kit, Java(TM) Technology Edition, Version 1.1.8

IBM OS/2 Warp Developer Kit, Java(TM) Technology Edition, Version 1.1.8 (Developer Kit) basiert auf Wartungsstufe 1.1.8 des Produkts Java von Sun Microsystems. Diese Datei beschreibt die Laufzeitkomponente des Developer Kits.

- Installation
- Java-Interpreter
- Applet-Ansicht
- Konfiguration
- Plattformspezifische Angaben
- Inaktivieren des JIT-Compilers
- Informationen zu DBCS-Umgebungen
- Adressen für weitere Informationen
- Bemerkungen

  ## Installation

  In der Informationsdatei (Readme) zum Developer Kit im Verzeichnis \JAVA11 finden Sie die neuesten Informationen zur Installation. Die Informationsdatei befindet sich nach der Installation des Produkts in dem Verzeichnis, in dem Sie die Dateien für das Developer Kit extrahiert haben.

  Während der Installation der Laufzeit-Software werden folgende Änderungen an den Anweisungen PATH und LIBPATH in der Datei CONFIG.SYS vorgenommen:

        PATH        x:\java11\bin wird hinzugefügt
        LIBPATH     x:\java11\dll wird hinzugefügt

  Hierbei gibt x das Laufwerk an, auf dem die Java-Laufzeit-Software installiert wurde.

  ## Java-Interpreter

  Der Java-Interpreter (JAVA) führt Java-Bytecodes aus. Java-Bytecode befindet sich in einer Datei mit der Erweiterung .class.

  Geben Sie zur Ausführung der Java-Anwendung hello.class folgendes in einer Befehlszeile ein:

              java  hello

  Hinweis: Bei dem Dateinamen wird zwischen Groß-/Kleinschreibung unterschieden, und die Erweiterung für die Datei darf nicht angegeben werden. (Es muß sich jedoch um eine .class-Datei handeln.)

  Java-Anwendungen, die AWT (Abstract Window Toolkit) verwenden, können mit dem Befehl JAVA gestartet werden. Der Befehl JAVAPM steht aus Gründen der Kompatibilität mit früheren Versionen des Developer Kits zwar noch zur Verfügung, wird jedoch nicht mehr benötigt.

  Dateien mit der Erweiterung .class werden vom Java-Compiler, JAVAC, erstellt. Der Java-Compiler gehört zum Lieferumfang des Java-Toolkit und wird nur benötigt, wenn Sie Java-Programme schreiben möchten.

  Wenn Sie in einer Befehlszeile den Befehl JAVA ohne weitere Optionen eingeben, wird eine Liste der verfügbaren Optionen angezeigt.

  ## Applet-Ansicht

  Java Applet-Ansicht (APPLET) bietet eine schnelle Methode zur Ausführung von Java-Minianwendungen. Wenn die angegebene HTML-Datei keine Java-Minianwendung enthält, werden keine Funktionen ausgeführt.

  Geben Sie zur Ausführung der in der Datei tictactoe.html enthaltenen Minianwendung folgendes in einer Befehlszeile ein:

             applet  tictactoe.html

  Wenn Sie den Befehl APPLET ohne weitere Optionen in einer OS/2-Befehlszeile eingeben, wird eine Liste der verfügbaren Optionen in einem Dialogfenster angezeigt.

  ## Konfiguration

  Das Verhalten der Java Laufzeit-Software kann über verschiedene Umgebungsvariablen verändert werden:

  SET JAVA_AUDIO_RATE=n
    Setzt die gewünschte Abtastrate für die Audiowiedergabe. Wird für n der Wert 8 angegeben, wird die Wiedergabe auf 8000 Samples pro Sekunde gesetzt. Bei dem Wert 11 wird eine Rate von 11025 Samples pro Sekunde verwendet. Die Java Laufzeit-Software versucht zunächst, eine Abtastrate von 8000, was dem ankommenden Datenstrom entspricht, und dann von 11025 zu verwenden.

    Einige ältere Treiber, wie beispielsweise manche ThinkPad 701C-Treiber mit einem Datum vor Oktober 1995, scheinen zunächst eine Abtastrate von 8000 zu unterstützen, schlagen dann jedoch fehl. Wird die Wiedergaberate für diese Treiber auf 11025 gesetzt, können sie noch verwendet werden.

  SET JAVA_AUDIO_VOLUME=v
    Stellt den Lautstärkepegel der Audioausgabe ein. v gibt hierbei den Prozentsatz der maximalen Lautstärke von 0 bis 100 an. Der Standardwert ist 75.

  SET JAVA_SOUND_MODE=ON
    Es gibt zwei Methoden, Klang zu erzeugen: Memory Playlist und Direct Audio Real Time (DART). DART ist die Standardeinstellung. Sie gewährleistet eine bessere CPU-Auslastung und Antwortzeit. Memory Playlist ist die ältere Methode zur Klangerzeugung. Sie unterstützt Abwärtskompatibilität für ältere, langsamere Audioprogramme.

    Sie können mit beiden Methoden Java 1.1.x oder ältere Audioprogramme ausführen. Wenn Sie jedoch keine älteren, langsameren Audioprogramme unterstützen müssen, brauchen Sie die Standardeinstellung (DART) nicht zu ändern. Nachstehend finden Sie Informationen zur Verwendung von Memory Playlist und DART.

    Geben Sie den folgenden Befehl in der Befehlszeile ein, oder definieren Sie ihn in der Datei CONFIG.SYS, um Memory Playlist zu verwenden:

        SET JAVA_SOUND_MODE=ON

    Geben Sie den folgenden Befehl in der Befehlszeile ein, oder definieren Sie ihn in der Datei CONFIG.SYS, um die Umgebungsvariable zu inaktivieren und DART zu verwenden:

        SET JAVA_SOUND_MODE=

  SET JAVA_COMPILER=<xyz>
    Gibt den Namen des JIT-Compilers (Just In Time) an, der geladen werden soll. Der Standardwert ist JAVAX.

    Informationen zum Inaktivieren des JIT-Compilers finden Sie im Abschnitt Inaktivieren des JIT-Compilers.

  SET JAVA_CONSOLE=<1>
    Gibt an, daß die über die Befehle JAVA und APPLET gestarteten Java-Programme über ein Java-Fenster ausgeführt werden.

  SET JAVA_HOME=<dir>
    Gibt den Pfad für die gemeinsam benutzten Java-Laufzeitverzeichnisse an.

  SET JAVA_NLS_SBCS=1
    Gibt an, daß Java-Anwendungen im SBCS-Modus (Single Byte Character Set - Einzelbytezeichensatz) ausgeführt werden sollen, und zwar auch in DBCS-Umgebungen (Double Byte Character Set - Doppelbytezeichensatz).

  SET JAVA_NOPRINTDLG=1
    Gibt an, daß Java-Anwendungen die Anzeige des Dialogfensters mit den Druckermerkmalen vor einem Druckvorgang unterdrücken sollen. Hiermit können Jobs unter Verwendung der Standarddruckermerkmale gedruckt werden, ohne daß ein Benutzereingriff erforderlich ist.

  SET JAVA_USER=<dir>
    Gibt den Pfad für benutzerspezifische Dateien an, wie zum Beispiel für die Datei hotjava\property.

  SET JAVA_WEBLOGS=<dir>
    Gibt den Pfad für das Verzeichnis an, in das Web-Protokolldateien für jeden gestarteten Java-Prozeß geschrieben werden.

  SET JAVA_NORESTART=1
    Gibt an, daß der Befehl JAVA nicht als Präsentationsmanagerprozeß erneut gestartet werden soll.

  SET JAVA_CLOCK_RESOLUTION
    Ermöglicht die Angabe der Zeitgeberauflösung, die von der Methode currentTimeMillis in der Klasse java.lang.System gefordert wird. Die Auflösung wird in Millisekunden angegeben. Beispiel:

        SET JAVA_CLOCK_RESOLUTION = 1

    Diese Angabe setzt das Minimum für die Zeitgeberauflösung für Java-Anwendungen, die currentTimeMillis verwenden, auf 1 Millisekunde (die höchste Auflösung).

    Welche Zeitgeberauflösungen verfügbar sind, hängt davon ab, welche Zeitgeberauflösungen vom Betriebssystem OS/2 bereitgestellt werden. Das Java-System rundet auf die nächste verfügbare Auflösung ab. Die höchste Auflösung, 1 Millisekunde, ist immer verfügbar. Der Standardwert für JAVA_CLOCK_RESOLUTION ist 10 Millisekunden. Dieser Wert wird in der Regel auf die Genauigkeit von 1 Millisekunde gerundet.

    Wollen Sie die bestmögliche Java-Leistung bei Verwendung von currentTimeMillis erreichen, verwenden Sie folgenden Befehl:

        set JAVA_CLOCK_RESOLUTION = 32

    Dies kann bei der Durchführung von Java-Benchmark-Tests wichtig sein.

  ## Plattformspezifische Angaben

  Für OS/2 sind eine Reihe plattformspezifischer Änderungen erforderlich:

  ### Allgemein

  - Die Umgebungsvariable HOME wird als JAVA_USER bezeichnet.

  ### Applet-Ansicht

  - Das Programm Applet-Ansicht wird als APPLET bezeichnet.

  - stdin, stdout und stderr werden in das OS/2-Fenster umgeleitet, in dem Applet-Ansicht gestartet wurde.

  - Wenn Applet-Ansicht direkt als Präsentationsmanagerprogramm gestartet wird (wie im folgenden Befehl), wird die Ausgabe von stdout und stderr in das Verzeichnis WEBLOGS umgeleitet. Dies können Sie mit folgendem Befehl erreichen:

             start /PM applet.exe beispiel1.html

    Mit der Option -nore kann diese Umleitung verhindert werden.

  ### Java-Anwendungen

  - Wenn eine Java-Anwendung, die AWT (Abstract Window Toolkit) verwendet, mit dem Befehl JAVA gestartet wird, wird die Anwendung als ein Präsentationsmanagerprozeß erneut gestartet. Bei einem solchen Neustart werden stdin, stdout und stderr in das OS/2-Fenster umgeleitet, in dem der Befehl JAVA abgesetzt wurde.

  - Soll verhindert werden, daß der Befehl JAVA als Präsentationsmanagerprozeß neu gestartet wird, geben Sie die Option -norestart ein. Alternativ hierzu können Sie auch die Umgebungsvariable JAVA_NORESTART verwenden. Wenn ein Java-Programm, das AWT verwendet, mit java -norestart in einer anderen als einer Präsentationsmanagersitzung gestartet wird, können aufgrund einer für den OS/2-Präsentationsmanager geltenden Einschränkung keine Fenster erstellt werden.

  - Zur Anzeige der Ausgabe von stdout und stderr für Java-Programme, die mit dem Befehl JAVA oder APPLET als OS/2-Präsentationsmanagerprozesse ausgeführt werden, steht ein Java-Fenster zur Verfügung. Geben Sie zur Ausführung über das Java-Fenster entweder die Option -cons an, oder verwenden Sie die Umgebungsvariable JAVA_CONSOLE.

  - Wenn Sie eine Java-Anwendung starten, die ein Nicht-Präsentationsmanagerprogramm aufruft, verwenden Sie bitte die Option -norestart. Ruft beispielsweise die Java-Anwendung JavaApp ein Nicht-Präsentationsmanagerprogramm auf, starten Sie diese Anwendung mit folgender Eingabe in einer OS/2-Befehlszeile:

        java -norestart JavaApp

    Verwenden Sie die Option -norestart nicht, treten Fehler auf.

  ## Inaktivieren des JIT-Compilers

  Zum Lieferumfang des Developer Kit gehört ein JIT-Compiler (Just In Time). Der JIT-Compiler erstellt Maschinencode für häufig verwendete Bytecodesequenzen in einer Java-Anwendung oder Java-Minianwendung noch während der Ausführung. Der JIT-Compiler ist standardmäßig aktiviert.

  Sie können den JIT-Compiler inaktivieren, um beispielsweise mögliche Probleme mit einer Java-Anwendung, einer Java-Minianwendung oder dem Compiler selbst einzugrenzen, indem Sie dem Interpreter der Java Laufzeit-Software folgenden Befehl übergeben:

       -nojit

  Die virtuelle Maschine interpretiert Bytecodes direkt, ohne sie in Basiscode umzuwandeln.

  ## Informationen zu DBCS-Umgebungen

  - Schriftarten mit Einzelbytebreite in Sprachen mit DBCS-Schriftartzeichensätzen (Double Byte Character Set - Doppelbytezeichensatz), wie zum Beispiel die Katakana-Schriftarten mit halber Breite in den japanischen Schriftartzeichensätzen, können mit AWT-Komponenten nicht dargestellt werden.

    Laut JavaSoft-Spezifikation unterstützt das Developer Kit nur Schriftartzeichensätze für Englisch. Wenn bei AWT-Komponenten die Ausgabe in DBCS-Sprachen erfolgen soll, verwendet das Developer Kit die Funktion für die DBCS-Schriftartzuordnung. Aufgrund einer Einschränkung in dieser Zuordnungsfunktion kann das Developer Kit mit AWT-Komponenten keine Schriftarten mit Einzelbytebreite in DBCS-Sprachen ausgeben.

  - Klassennamen dürfen keine DBCS-Zeichen enthalten.

  - Mininanwendungen können keine für Parameterbefehle gesetzten DBCS-Zeichenfolgewerte (unter Verwendung der Methode getParameter()) erhalten, wenn sie über Applet-Ansicht, APPLET, ausgeführt werden.

  ## Adressen für weitere Informationen

  Wenn Sie sich über den neuesten Stand der Entwicklungen bei Java und IBM informieren wollen, besuchen Sie die IBM Java Home Page oder die Web-Site von Sun.

  ## Bemerkungen

  Marken

  Folgende Namen sind in gewissen Ländern Marken der IBM Corporation:

  - IBM
  - OS/2

  Folgende Namen sind in gewissen Ländern Marken anderer Unternehmen:

  - Java ist eine Marke der Sun Microsystems, Inc.
  - Eigentum und Exklusivrechte an der Java(TM)-Technologie liegen in gewissen Ländern bei Sun Microsystems, Inc.

  Copyright-Angaben

  - (C) Copyright Sun Microsystems, Inc. 1992-1998. Alle Rechte vorbehalten.
  - (C) Copyright IBM Corporation, 1996-1998. All rights reserved.
  - (C) Copyright IBM Deutschland Informationssysteme GmbH, 1996-1998.
    Alle Rechte vorbehalten.
  - Dieses Produkt resultiert zum Teil aus der Arbeit der Independent JPEG Group.