# IBM Runtime Environment for Linux on AMD64 architecture, Java 2 Technology Edition, Version 1.4.2

# Runtime Environment ユーザー・ガイド

# 著作権情報

注: 本書および本書で紹介する製品をご使用になる前に、『特記事項』に記載されている情報をお読みください。

本書は、IBM Runtime Environment for Linux on AMD64 architecture, Java 2 Technology Edition, Version 1.4.2 に適用されます。

(c) Copyright Sun Microsystems, Inc. 1997, 2003, 901 San Antonio Rd., Palo Alto, CA 94303 USA. All rights reserved.

(c) Copyright International Business Machines Corporation, 1999, 2004. All rights reserved. (c) Copyright IBM Japan 2004

# まえがき

本書では、IBM(R) Runtime Environment for Linux(TM) on AMD64 architecture について説明します。

IBM Runtime Environment には Java(TM) 仮想マシン (JVM)、コア Sun Microsystems Java クラス、およびそれらをサポートするファイルが含まれています。Runtime Environment に、SDK パッケージにあるすべてのクラスが含まれているわけではありません。

本書には、Runtime Environment についての一般的な情報と、Runtime Environment の Sun のインプリメンテーションと IBM のインプリメンテーションの相違点についての情報を記載しています。本書は、Sun の Web サイト (http://java.sun.com) の詳細な資料と一緒にお読みください。

IBM JVM について詳しくは、「IBM JVM Diagnostics Guide」を参照してください。

SDK for Linux をテスト済みのディストリビューションのリストについては、http://www-106.ibm.com/developerworks/java/jdk/linux/tested.html を参照してください。

SDK には、Java アプリケーションの実行のみを可能にする Runtime Environment for Linux が組み込まれていることに注意してください。SDK をインストールしている場合には、Runtime Environment が組み込まれています。

用語「Runtime Environment」と「Java 仮想マシン」は、本書を通じて読み替えることができます。

# 目次

著作権情報
まえがき
概要
Runtime Environment for Linux に含まれているファイル
ご使用条件
just-in-time (JIT) コンパイラー
Java Native Interface および Native Method Interface
Runtime Environment の構成
Runtime Environment for Linux のアンインストール
インストール可能な Red Hat Package Manager (RPM) パッケージのアンインストール
圧縮 Tape Archive (TAR) パッケージのアンインストール
Java アプリケーションの起動
コマンドの要約
オプション
標準オプション
非標準オプション
java コマンドのグローバリゼーション
クラスパスの処理
ガーベッジ・コレクション・ポリシーの指定
休止時間
休止時間の削減
ヒープが満杯の環境
JVM によるシグナルの処理方法
JVM が使用するシグナル
ネイティブ・コード・ドライバーをシグナル・チェーニング・ライブラリーにリンクする
RMI の Connection Handler Pool のインプリメント
IBM ビルド番号およびバージョン番号の取得
浮動スタックの処理
DBCS 言語のインプット・メソッドの切り替え
ユーザー・システムへのアプリケーションのインストール
既知の制限
特記事項
商標

# 概要

Runtime Environment には、Java 仮想マシン、Java クラス、およびそれをサポートするファイルが用意されています。Runtime Environment には、SDK に含まれているクラスの一部のみが含まれており、Java クラスの実行は可能ですが、Java プログラムをコンパイルすることはできません。

## Runtime Environment for Linux に含まれているファイル

Runtime Environment for Linux には、実行時にプログラムをサポートするために必要な、バイナリー・オブジェクト・ファイルとクラス・ファイルが含まれています。Runtime Environment for Linux には、appletviewer や Java コンパイラー (javac) などの開発ツールや、開発システムにのみ関連するクラスは含まれていません。

さらに、Java Communications アプリケーション・プログラミング・インターフェース (API) パッケージが、Runtime Environment for Linux と一緒に使用するように用意されています。 Java Communications API をインストールした場合、詳細については、「JavaComm API User Guide」を参照してください。

## ご使用条件

LICENSE_xx.html ファイルには、Runtime Environment for Linux ソフトウェアのご使用条件が入っています。(xx は言語の省略形です。)

このご使用条件を表示または印刷するには、このファイルを Web ブラウザーで開いてください。

## just-in-time (JIT) コンパイラー

just-in-time (JIT) コンパイラー (libjitc.so) は、Java アプリケーションやアプレットの実行中に、頻繁に使用されるバイトコード・シーケンスのマシン・コードを動的に生成します。

Runtime Environment for Linux には JIT (libjitc.so) が組み込まれていて、デフォルトで使用できます。Java アプリケーション、アプレット、またはコンパイラー自体のいずれに問題があるかを判別するために、JIT を使用しないようにすることができます。

JIT を使用不可にするには、-Xint オプションを使用します。アプリケーションを実行するシェル・プロンプト・ウィンドウで次のように入力します。

        java -Xint class

JIT が使用可能かどうかを確認するには、シェル ・プロンプトで次のように入力します。

        java -version

JIT が使用できる場合には、以下の入ったメッセージが表示されます。

    (JIT enabled)

JIT が使用できない場合には、以下の入ったメッセージが表示されます。

    (JIT disabled)

## Java Native Interface および Native Method Interface

Runtime Environment には Java Native Interface (JNI) が付属しています。 JNI の使用方法については、Sun の Web サイト (http://java.sun.com/j2se/1.4.2/docs/guide/jni) を参照してください。

本リリースでは Native Method Interface はサポートされていません。アプリケーションでこのインターフェースを使用しないでください。

# Runtime Environment の構成

Runtime Environment をインストールしたら、シェル・ログイン・スクリプトを編集して、次のディレクトリーを PATH ステートメントに追加します。

/opt/IBMJava2-amd64-142/jre/bin

Runtime Environment を /opt/IBMJava2-amd64-142/ 以外のディレクトリーにインストールした場合は、/opt/IBMJava2-amd64-142/ を、 Runtime Environment のインストール・ディレクトリーに置き換えます。

# Runtime Environment for Linux のアンインストール

Runtime Environment for Linux を除去するために使用するプロセスは、インストール可能な Red Hat Package Manager (RPM) パッケージをインストールしているか、圧縮 Tape Archive (TAR) パッケージをインストールしているかによって異なります。詳細については、『インストール可能な Red Hat Package Manager (RPM) パッケージのアンインストール』または『圧縮 Tape Archive (TAR) パッケージのアンインストール』を参照してください。

## インストール可能な Red Hat Package Manager (RPM) パッケージのアンインストール

インストール可能な RPM パッケージをインストールしている場合に、Runtime Environment for Linux をアンインストールするには:

1. シェル・スクリプトで次のように入力します。

   -         rpm -e IBMJava2-JRE-AMD64-1.4.2-0.0

   あるいは、kpackage や yast2 などのグラフィック・ツールを使用することもできます。
2. PATH ステートメントから、Runtime Environment をインストールしているディレクトリーを除去します。

## 圧縮 Tape Archive (TAR) パッケージのアンインストール

圧縮 TAR パッケージをインストールしている場合に、Runtime Environment for Linux をアンインストールするには:

1. Runtime Environment ファイルを、 Runtime Environment をインストールしているディレクトリーから除去します。
2. PATH ステートメントから、Runtime Environment をインストールしているディレクトリーを除去します。

# Java アプリケーションの起動

java ツールは Java アプリケーションを起動します。これは、Java の初期クラス名をパラメーターとして必要とします。これを指定しなかった場合、使用法のメッセージが出力されます。

JVM は、初期クラスと使用されるその他のクラスを、ブートストラップ・クラスパス、インストールされた拡張機能、ユーザー・クラスパスの 3 箇所で検索します。クラス名または JAR ファイル名の後の引き数が main 関数に渡されます。

javaw コマンドは、javaw には関連するコンソール・ウィンドウがないことを除けば、java とまったく同じです。コマンド・プロンプト・ウィンドウを表示したくない場合には javaw を使用してください。 javaw ランチャーは、起動に失敗した場合に、エラー情報を含むダイアログ・ボックスを表示します。

## コマンドの要約

java および javaw コマンドの構文は次のとおりです。

    java [ options ] class [ arguments ... ]
    java [ options ] -jar file.jar [ arguments ... ]
    javaw [ options ] class [ arguments ... ]
    javaw [ options ] -jar file.jar [ arguments ... ]

大括弧で囲まれている項目はオプショナルです。

options
  コマンド行オプション。
class
  呼び出すクラスの名前。
file.jar
  呼び出す jar ファイルの名前。-jar でのみ使用されます。
argument
  main 関数に渡される引き数。

-jar オプションが指定された場合には、指定された JAR ファイルにアプリケーションのクラスおよびリソース・ファイルが入っていて、始動クラスは Main-Class マニフェスト・ヘッダーで示されています。

## オプション

ランチャーには、現在の Runtime Environment でサポートされ、将来のリリースでサポートされる標準オプションのセットがあります。このほかに、非標準オプションのセットがあります。

### 標準オプション

- -D<property_name>=<value>
  - システム・プロパティーを設定します。
- -assert
  - assert 関連オプションのヘルプを表示します。
- -cp または -classpath <: で区切られたディレクトリーおよび zip ファイルまたは jar ファイル
  - アプリケーションのクラスおよびリソースの検索パスを設定します。-classpath も -cp も使用しないで、CLASSPATH を設定しないと、ユーザー・クラスパスは、デフォルトでは現行ディレクトリー (.) です。『クラスパスの処理』も参照してください。
- -help または -?
  - 使用法メッセージを表示します。
- -showversion
  - 製品のバージョンを表示して継続します。
- -verbose:[class | gc | dynload | stack | debug | sizes | stackwalk]
  - 詳細出力を使用可能にします。
- -version
  - 製品のバージョンを表示します。
- -X
  - 非標準オプションのヘルプを表示します。

### 非標準オプション

以下にリストした -X オプションは、非標準であり、予告なしに変更されることがあります。

- -Xargencoding
  - 引き数リストに Unicode のエスケープ・シーケンスを使用できるようにします。
- -Xbootclasspath:<; で区切られたディレクトリーおよび zip ファイルまたは jar ファイル>
  - ブートストラップ・クラスおよびリソースの検索パスを設定します。
- -Xbootclasspath/a:<; で区切られたディレクトリーおよび zip ファイルまたは jar ファイル>
  - 指定されたディレクトリー、zip ファイル、または jar ファイルをブートストラップ・クラス・パスの最後に付加します。
- -Xbootclasspath/p:<; で区切られたディレクトリーおよび zip ファイルまたは jar ファイル>
  - 指定されたディレクトリー、zip ファイル、または jar ファイルをブートストラップ・クラス・パスの前に付加します。-Xbootclasspath: または -Xbootclasspath/p: オプションを使用して core.jar、graphics.jar、server.jar、security.jar、xml.jar、tools.jar、または charsets.jar をオーバーライドするアプリケーションを配布しないでください。そのような配布は、Java 2 Runtime Environment バイナリー・コードのライセンス違反になります。
- -Xcheck:jni
  - JNI 機能の追加検査を行います。-Xrunjnichk を使用することも可能です。
- -Xcheck:nabounds
  - JNI 配列操作の追加検査を行います。-Xrunjnichk を使用することも可能です。
- -Xcompactexplicitgc
  - `System.gc()` の呼び出しのたびにコンパクトを行います。-Xnocompactexplicitgc も参照してください。
- -Xcompactgc
  - ガーベッジ・コレクターのサイクルごとにコンパクトを行います。-Xnocompactgc も参照してください。
- -Xdbg:<options>
  - アプリケーションのリモート・デバッグをサポートするデバッグ・ライブラリーをロードします。これは、-Xrunjdwp と同じです。
- -Xdbginfo:<path to symbol file>
  - オプションを読み込み、デバッグ情報サーバーに渡します。
- -Xdisablejavadump
  - エラーが発生したときに、javadump の代わりにシステム・ダンプが生成されるようにします。
- -Xdebug
  - デバッガーを使用可能にして JVM を開始します。
- -Xdisableexplicitgc
  - `System.gc()` の呼び出しをノーオペレーション (NOP) に変更します。
- -Xfuture
  - 厳密なクラス・ファイル・フォーマット検査をオンにします。Java アプリケーション・ランチャーの将来のリリースでは、より厳密な検査がデフォルトになるため、新しいコードを開発する際はこのフラグを使用してください。
- -Xgc:<options>
  - ガーベッジ・コレクターに verbose、compact、nocompact などのオプションを渡します。
- -Xgcpolicy:[:optthruput]|[:optavgpause]
  - ガーベッジ・コレクターの振る舞いを制御します。デフォルトは optthruput オプションであり、これは、アプリケーションに対して非常に高いスループットを提供しますが、時折、休止が発生するという代償があります。optavgpause オプションは、これらのガーベッジ・コレクション休止に費やされる時間を削減すると共に、ヒープ・サイズの増加がガーベッジ・コレクション休止の長さに与える影響を制限します。非常に大きなヒープを使用する構成の場合は、optavgpause を使用してください。
- -Xgcthreads<number of threads>
  - ガーベッジ・コレクションを実行する必要のあるスレッド数を設定します。
- -Xinitsh<size>
  - システム・クラスを保持するよう指定されたストレージの初期サイズを設定します。
- -Xint
  - JVM がインタープリターのみを使用するようにし、JIT および AOT を使用不可にします。
- -Xiss
  - Java の初期スレッド・スタック・サイズを設定します。
- -Xjit[:<number of threads>]
  - JIT を使用可能にするか、JIT にオプションを渡すか、あるいはその両方を行います。-Xnojit も参照してください。
- -Xlinenumbers
  - デバッグ用に行番号を使用可能にします。-Xnolinenumbers も参照してください。
- -Xmaxe<size>
  - ガーベッジ・コレクターがヒープを拡張する量の最大値を設定します。一般に、ガーベッジ・コレクターは、フリー・スペースの量が 30% (または -Xminf を使用して指定した量) よりも少なくなると、フリー・スペースを 30％ に戻すために必要な量だけ、ヒープを拡張します。-Xmaxe オプションは、拡張を指定の値に制限します。例えば、`-Xmaxe10M` の場合は、拡張が 10MB に制限されます。
- -Xmaxf<size>
  - ガーベッジ・コレクション後に解放されなければならない、ヒープの最大パーセントを指定します。フリー・スペースがこの量を超えた場合、JVM はヒープの縮小を試みます。0 から 1 の範囲の小数点の値としてサイズを指定します。例えば、`-Xmaxf0.5` の場合は、最大フリー・スペースが 50% に設定されます。デフォルト値は 0.6 です。
- -Xmca<size>
  - 指定されたサイズで RAM クラス・セグメントが増分するように設定します。
- -Xmco<size>
  - 指定されたサイズで ROM クラス・セグメントが増分するように設定します。
- -Xmine<size>
  - ガーベッジ・コレクターがヒープを拡張する量の最小値を設定します。一般に、ガーベッジ・コレクターは、フリー・スペースの量を 30% (または -Xminf を使用して指定した量) に戻すために必要な量だけ、ヒープを拡張します。-Xmine オプションは、拡張が、指定された値以上になるように設定します。例えば、`-Xmine50M` は、拡張サイズを最小 50MB に設定します。
- -Xminf<size>
  - ガーベッジ・コレクション後に解放されなければならないヒープの最小パーセントを指定します。フリー・スペースがこの量を下回った場合、JVM はヒープの拡張を試みます。0 から 1 の範囲の小数点の値としてサイズを指定します。例えば、`-Xminf0.3` は、最小フリー・スペースがヒープの 30% になるように要求します。
- -Xmjit[:<number of threads>]
  - MicroJIT を使用可能にするか、MicroJIT にオプションを渡すか、あるいはその両方を行います。
- -Xmn<size>
  - 新しいヒープのサイズを、指定された値に設定します。
- -Xmo<size>
  - Java の初期ヒープ・サイズを設定します。-Xms を使用することも可能です。
- -Xmoi<size>
  - Java の初期ヒープ・サイズを増分します。
- -Xmr<size>
  - 記憶済みセット・サイズを設定します。
- -Xms<size>
  - Java の初期ヒープ・サイズを設定します。-Xmo を使用することも可能です。
- -Xmso<size>
  - OS スレッド・スタックのサイズを設定します。
- -Xmx<size>
  - Java の最大ヒープ・サイズを設定します。
- -Xnm
  - モニター・プールのサイズを指定します。
- -Xnoagent
  - 古い sun.tools.debug インターフェースを使用不可にし、JPDA デバッグ・サポートを使用できるようにします。
- -Xnoaot
  - AOT を使用不可にします。
- -Xnoclassgc
  - クラス・ガーベッジ・コレクションを使用不可にします。これは、JVM で使用されなくなった Java クラスに関連付けられているストレージのガーベッジ・コレクションをオフに切り替えます。
- -Xnocompactgc
  - ガーベッジ・コレクターのコンパクトを使用不可にします。-Xcompactgc も参照してください。
- -Xnocompactexplicitgc
  - `System.gc()` の呼び出し時のコンパクトを使用不可にします。-Xcompactexplicitgc も参照してください。
- -Xnojit
  - JIT を使用不可にします。-xjit も参照してください。
- -Xnolinenumbers
  - デバッグ用の行番号を使用不可にします。-Xlinenumbers も参照してください。
- -Xnopartialcompactgc
  - `System.gc()` の呼び出し時の増分コンパクトを使用不可にします。-Xpartialcompactgc も参照してください。
- -Xnosigcatch
  - JVM リカバリー・コードを使用不可にします。-Xsigcatch も参照してください。
- -Xnosigchain
  - シグナル・ハンドラーのチェーニングを使用不可にします。-Xsigchain も参照してください。
- -Xoptionsfile=<file>
  - JVM オプションが定義されているファイルを指定します。
- -Xoss<size>
  - スレッドの最大 Java スタック・サイズを設定します。
- -Xpartialcompactgc
  - `System.gc()` の呼び出し時の増分コンパクトを使用可能にします。-Xnopartialcompactgc も参照してください。
- -Xquickstart
  - コンパイルを遅延することにより、起動時間を改善します。
- -Xrdbginfo:<host>:<port>
  - オプションを読み込み、リモートのデバッグ情報サーバーに渡します。
- -Xrs
  - オペレーティング・システムのシグナルの使用を減らします。
- -Xrunlibrary_name[:options]
  - ヘルパー・ライブラリーをロードします。複数のライブラリーをロードするには、コマンド行で 2 回以上指定してください。これらのライブラリーの例は次のとおりです。
    - -Xrunhprof[:help] | [:<option>=<value>, ...]
      - ヒープ、CPU、またはモニターのプロファイル作成を実行します。
    - -Xrunjdwp[:help] | [:<option>=<value>, ...]
      - アプリケーションのリモート・デバッグをサポートするデバッグ・ライブラリーをロードします。これは、-Xdbg と同じです。
    - -Xrunjnichk[ :verbose | trace | profile | nonfatal | nowarn | noadvice | pedantic | help]
      - JNI 機能の追加検査を行います。
- -Xsigcatch
  - JVM リカバリー・コードを使用可能にします。-Xnosigcatch も参照してください。
- -Xsigchain
  - シグナル・ハンドラーのチェーニングを使用可能にします。-Xnosigchain も参照してください。
- -XsigquitToFile<path to file><filename>
  - sigquit トレースからの情報を、指定されたファイルにダンプします。
- -Xss<size>
  - スレッドの最大ネイティブ・スタック・サイズを設定します。詳細については、『浮動スタックの処理』を参照してください。
- -Xthr:<options>
  - スレッド化オプションを設定します。
- -Xverbosegclog:<path to file><filename>[X, Y]
  - verboseGC の出力を指定したファイルに書き込みます。ファイルがすでに存在していると、上書きされます。それ以外の場合で、既存ファイルを開けないか、新しいファイルを作成できない場合は、出力は stderr にリダイレクトされます。引き数 X および Y (両方とも整数) を指定すると、verboseGC 出力は X 個のファイルに順にリダイレクトされ、それぞれのファイルには、Y 個の gc サイクルの verboseGC 出力が含まれます。これらのファイルは、filename1、filename2、... という形式になります。
- -Xverify
  - ロードされるすべてのクラスについて厳密なクラス検査を使用可能にします。
- -Xverify:none
  - 厳密なクラス検査を使用不可にします。

## java コマンドのグローバリゼーション

java コマンドやその他の java ランチャー・コマンド (javaw など) によって、クラス名を現行ロケールの文字セット内の任意の Unicode 文字として指定できます。

java エスケープ・シーケンスを使用して、クラス名と引き数に任意の Unicode 文字を指定することもできます。これを行うには、 -Xargencoding を指定する必要があります。Unicode 文字を指定するには、エスケープ・シーケンスを `¥u####` の形式で使用します。ここで # は 16 進数字 (0 から 9、A から F) です。

あるいは、クラス名およびコマンド引数を UTF8 エンコード方式で指定するには、-Xargencoding:utf8 を使用し、ISO8859_1 エンコード方式で指定するには、-Xargencoding:latin を使用します。

java および javaw コマンドは、翻訳された出力メッセージを渡します。これらのメッセージは、Java を実行しているロケールによって異なります。java が戻す、エラーの詳細説明やその他のデバッグ情報は、英語で表示されます。

## クラスパスの処理

クラス名を、フルパスおよび .class 拡張子を含む完全ファイル名として指定することができます。以前のバージョンでは、CLASSPATH に関連したクラスを指定できただけで、.class 拡張子は使用できませんでした。完全ファイル名を使用すれば、java アプリケーションをデスクトップやファイル・ランチャーから起動することができます。.class ファイルをパスおよび拡張子と共に指定すると、指定したパスが CLASSPATH に組み込まれます。 例えば、コマンド `java ~/myapp/thisapp.class` は、`java -classpath ~/myapp thisapp` を指定した場合と同じ働きをします。

## ガーベッジ・コレクション・ポリシーの指定

-Xgcpolicy JVM ランタイム・オプションは、ガーベッジ・コレクション・ポリシーを指定します。

-Xgcpolicy は、値として optthruput (デフォルト)、optavgpause、または gencon を使用します。このオプションは、ガーベッジ・コレクターの動作を制御して、アプリケーションおよびシステム全体のスループットとガーベッジ・コレクションに起因する休止時間とのトレードオフを行います。

このオプションの形式と値は次のとおりです。

> -Xgcpolicy:optthruput

> -Xgcpolicy:optavgpause

> -Xgcpolicy:gencon

### 休止時間

アプリケーションがオブジェクトを作成しようとしてその要求がヒープ内の使用可能スペースからすぐに満たされないとき、ガーベッジ・コレクターには、参照されていないオブジェクト (ガーベッジ) を識別してそれらを削除し、ヒープの状態を即時および後続の割り振り要求にすぐに応じられるような状態に戻す役割があります。そのようなガーベッジ・コレクションのサイクルによって、アプリケーション・コードの実行において予期しない休止が時々起こる場合があります。アプリケーションは大きく複雑になってきており、ヒープもそれに応じて大規模になっているので、このガーベッジ・コレクション休止時間は長さも重要度も増す傾向にあります。デフォルトのガーベッジ・コレクション値である optthruput は、これらの時々の休止 (ヒープのサイズとガーベッジの質によって数ミリ秒からかなりの秒数まであり得る) を犠牲にして、非常に高いスループットをアプリケーションにもたらします。

### 休止時間の削減

JVM では、以下の 2 つの技法を使用して休止時間を削減します。

- コンカレント・ガーベッジ・コレクション
- 世代別ガーベッジ・コレクション

-Xgcpolicy:optavgpause コマンド行オプションを指定すると、コンカレント・ガーベッジ・コレクションの使用が要求され、ガーベッジ・コレクション休止に費やす時間を大幅に削減することができます。コンカレント GC は、一部のガーベッジ・コレクション・アクティビティーを通常のプログラム実行と並行して実行して、ヒープの収集による分断を最小化することにより、休止時間を削減します。また、-Xgcpolicy:optavgpause オプションは、ヒープ・サイズの増加がガーベッジ・コレクション休止の長さに与える時間を制限します。-Xgcpolicy:optavgpause オプションは、大きなヒープを使用する構成の場合に、最も役立ちます。休止時間を削減することによって、アプリケーションのスループットがある程度減少する場合があります。

コンカレント・ガーベッジ・コレクション中に、その時に収集できない、比較的長期間存続しているオブジェクトを識別するために、かなりの量の時間が費やされます。GC が、再利用できる可能性の高いオブジェクトのみに集中すれば、一部のアプリケーションの休止時間をさらに削減することができます。世代別 GC では、ヒープを 2 つの「世代」、つまり「nursery」領域と「tenure」領域に分けることにより、これを実現します。オブジェクトは、その経過時間に応じて、これらの領域のいずれかに入れられます。nursery は 2 つのうちの小さい方であり、若いオブジェクトが入れられます。tenure は大きい方であり、古いオブジェクトが入れられます。オブジェクトは最初は nursery に割り振られます。これらのオブジェクトは、十分な期間生き残ると、プロモートされて、最終的に tenure 領域に移されます。

世代別 GC は、大部分のオブジェクトが長期間存続しないことを前提としています。世代別 GC では、最も再利用可能な空間を持つ nursery の空間の再利用に集中することで、休止時間を削減します。nursery の場合、ヒープ全体を収集するために時折長い休止時間をとる代わりに、収集が頻繁に行われます。また、nursery の大きさが十分に小さければ、休止時間は比較的短期間になります。ただし、世代別 GC には、長期間存続しているオブジェクトの数が多すぎる場合、tenure 領域がいっぱいになる可能性があるという欠点があります。この状態が発生したときに休止時間を最小化するには、コンカレント GC と世代別 GC を組み合わせて使用します。-Xgcpolicy:gencon オプションは、コンカレント GC と世代別 GC の組み合わせを使用することを要求することで、任意のガーベッジ・コレクション休止に費やされる時間を最小化する手助けをします。

### ヒープが満杯の環境

Java ヒープが満杯に近く、再利用できるガーベッジが少ししかない場合、すぐに使用可能なスペースがないため、新規オブジェクト用の要求がすぐには満たされないことがあります。ヒープが容量いっぱいに近い状態で操作されている場合、上記オプションのどちらが使用されているのかには関係なく、アプリケーション・パフォーマンスは悪くなります。また、さらにヒープ・スペースの要求が続けば、アプリケーションはメモリー不足例外を受け取り、その例外がキャッチされ処理されなければ、JVM は終了します。この時点で、JVM は「javadump」という診断ファイルを作成します。このような状態の場合、-Xmx オプションを使用してヒープ・サイズを増やすか、使用中のアプリケーション・オブジェクトの数を減らすことをお勧めします。

# JVM によるシグナルの処理方法

JVM に関係のあるシグナルが生じると、シグナル・ハンドラーが呼び出されます。このシグナル・ハンドラーは、Java スレッドのために呼び出されたのか、または Java 以外のスレッドのために呼び出されたのかを判別します。

シグナルが Java スレッドのためのものである場合、JVM がシグナル処理の制御を行います。このシグナル用のアプリケーション・ハンドラーがインストールされている場合、-Xnosigchain コマンド行オプションを指定しなかったときは、JVM の処理が完了した後で、このシグナル用のアプリケーション・ハンドラーが呼び出されます。

シグナルが Java 以外のスレッドのためのものであり、インストール済みのアプリケーションに、以前に JVM がそのシグナル用の独自のハンドラーをインストールしている場合、制御はそのハンドラーに与えられます。そうでない場合、JVM または Java アプリケーションによってシグナルが要求されると、シグナルが無視されるか、デフォルトのアクションが行われます。

例外およびエラーのシグナルの場合、JVM は以下のいずれかを行います。

- 条件を処理し、リカバリーします。あるいは、
- 以下を JVM が行った場合、制御されたシャットダウン・シーケンスに入ります。
  1. 障害発生時点の JVM の状態を示す Javadump を出力する
  2. そのシグナルのためのユーザー・アプリケーションのシグナル・ハンドラーを呼び出す
  3. アプリケーションがインストールした何らかの打ち切りフックを呼び出す
  4. クリーン・シャットダウンのために必要なクリーンアップを実行する

上記のフックを指定するランチャーを作成する方法について詳しくは、http://www-106.ibm.com/developerworks/java/library/i-signalhandling/ を参照してください。この項目は、Java V1.3.1 を対象に書かれたものですが、それ以降のバージョンにも適用されます。

割り込みシグナルの場合にも JVM は制御されたシャットダウン処理に入りますが、この場合は、以下を行う正常終了として扱われます。

- そのシグナルのためのユーザー・アプリケーションのシグナル・ハンドラーを呼び出す
- すべてのアプリケーション・シャットダウン・フックを実行する
- アプリケーションがインストールした何らかの終了フックを呼び出す
- 必要な JVM クリーンアップを実行する

このシャットダウンは、Java メソッド `System.exit()` を呼び出すことによって開始されるシャットダウンと同一です。

JVM が使用するその他のシグナルは内部制御の目的のものであり、終了の原因となることはありません。関係のある唯一の制御シグナルは SIGQUIT であり、Javadump を生成する原因となります。

## JVM が使用するシグナル

下記の表 1 は、JVM が使用するシグナルを示したものです。これらのシグナルは、以下のように、タイプまたは使用法ごとに表内でグループ化されています。

- 例外: 致命的な状態が発生すると、常にオペレーティング・システムが同期して該当する例外シグナルを生じさせるもの。
- エラー: JVM がリカバリーできない状態を検出した場合に、JVM が SIGABRT を生じさせるもの。
- 割り込み: シャットダウンを要求するために、JVM プロセスの外部から割り込みシグナルを非同期に生じさせるもの。
- 制御: 制御の目的で JVM が使用するその他のシグナル。

表 1. JVM が使用するシグナル
シグナル名 | シグナル・タイプ | 説明 | -Xrs による使用不可
--- | --- | --- | ---
SIGBUS | 例外 | メモリーに対する誤ったアクセス (データが不整列) | なし
SIGSEGV | 例外 | メモリーに対する誤ったアクセス (アクセス不能メモリーへの書き込み) | なし
SIGILL | 例外 | 正しくない命令 (不明なマシン・インストラクション呼び出しの試行) | なし
SIGFPE | 例外 | 浮動小数点例外 (0 除算) | なし
SIGABRT | エラー | 異常終了。JVM が JVM 障害を検出すると、このシグナルを生じさせます。 | なし
SIGINT | 割り込み | 対話式アテンション (CTRL-C)。JVM は正常に終了します。 | あり
SIGTERM | 割り込み | 終了要求。JVM は正常に終了します。 | あり
SIGHUP | 割り込み | ハングアップ。JVM は正常に終了します。 | あり
SIGQUIT | 制御 | 端末用の終了シグナル。JVM は、Javadump を取るためにこれを使用します。 | なし
SIGPIPE | 制御 | パイプの切断。SIG_IGN に設定します。 | なし

-Xrs (シグナル使用の削減) オプションを使用して、JVM がほとんどのシグナルを処理してしまうのを防止します。詳しくは、http://java.sun.com/j2se/1.4.2/docs/tooldocs/windows/java.html にある、Sun の Java アプリケーション・ランチャーのページを参照してください。

JVM スレッドに対するシグナル `1 (SIGHUP)`、`2 (SIGINT)`、`4 (SIGILL)`、`7 (SIGBUS)`、`8 (SIGFPE)`、`11 (SIGSEGV)`、および `15 (SIGTERM)` により、JVM はシャットダウンします。したがって、アプリケーション・シグナル・ハンドラーでは、JVM のサービスを必要としなくなった場合を除き、これらのシグナルからのリカバリーを試みるべきではありません。

## ネイティブ・コード・ドライバーをシグナル・チェーニング・ライブラリーにリンクする

Runtime Environment にはシグナル・チェーニングが含まれています。シグナル・チェーニングにより、JVM は、独自のシグナル・ハンドラーをインストールするネイティブ・コードとの、より効率的な相互操作が可能となります。

シグナル・チェーニングにより、アプリケーションでは、システム・ライブラリーの前に共用ライブラリー libjsig.so にリンクしてロードすることが可能になります。 libjsig.so ライブラリーにより、`signal()`、`sigset()`、および `sigaction()` などの呼び出しが確実にインターセプトされ、それらのハンドラーが JVM のシグナル・ハンドラーを置き換えることがなくなります。代わりに、これらの呼び出しは、新しいシグナル・ハンドラーを保管するか、または JVM がインストールしたハンドラーの後にそれらを「チェーニング」します。後で、これらのシグナルのいずれかが生じ、JVM をターゲットとしたものではないことが分かった場合、プリインストールされたハンドラーが起動します。

libjsig.so を使用するには、以下のようにします。

- 以下のように、JVM を作成または組み込むアプリケーションとリンクします。

      gcc -L$JAVA_HOME/bin -ljsig -L$JAVA_HOME/bin/j9vm -ljvm java_application.c

  または
- 以下のように、LD_PRELOAD 環境変数を使用します。

      export LD_PRELOAD=$JAVA_HOME/bin/libjsig.so; java_application (bash and ksh)

      setenv LD_PRELOAD=$JAVA_HOME/bin/libjsig.so; java_application (csh)

  (`JAVA_HOME` がすでに設定済みであると想定しています。設定されていない場合には、/opt/IBMJava2-amd64-142/jre を使用します。)

`sigaction()` を使用するシグナル・ハンドラーをインストールしている場合、JVM がシグナルを使用するときに、一部の sa_flags は見ることができません。これらは、以下のものです。

- SA_NOCLDSTOP - これは常に設定解除になっています。
- SA_NOCLDWAIT - これは常に設定解除になっています。
- SA_RESTART - これは常に設定されています。

libjsig.so ライブラリーも、アプリケーションから JVM シグナル・ハンドラーを隠します。このため、JVM が開始した後で行われた `signal()`、`sigset()`、および `sigaction()` などの呼び出しでは、JVM のシグナル・ハンドラーへの参照を戻すことがなくなりますが、JVM の開始前にインストールされたハンドラーがあれば、代わりにそれを戻します。

# RMI の Connection Handler Pool のインプリメント

デフォルトでは、RMI Connection Handlers の スレッド・プーリングは使用可能になっていません。

RMI TCPTransport レベルでインプリメントされた接続プーリングを使用可能にするには、以下のオプションを設定します。

    -Dsun.rmi.transport.tcp.connectionPool=true (or any non-null value)

このバージョンの Runtime Environment では、接続プール内のスレッド数を制限するために使用できる設定はありません。

詳しくは、Sun の Java のサイト http://java.sun.com を参照してください。

# IBM ビルド番号およびバージョン番号の取得

IBM ビルド番号およびバージョン番号を確認するには、シェル・プロンプトで以下を入力してください。

`java -version`

# 浮動スタックの処理

非浮動スタック Linux システムでは、-Xss の設定内容に関係なく、各スレッドに最小ネイティブ・スタック・サイズ 256 KB が提供されます。浮動スタック Linux システムでは、-Xss 値が使用されます。したがって、非浮動スタック Linux システムから移行する場合には、-Xss 値が十分大きく、最小の 256 KB に依存していないことを確認する必要があります。

# DBCS 言語のインプット・メソッドの切り替え

2 バイト文字セット (DBCS) システムでインプット・メソッドを切り替えたい場合には、 IBMJAVA_INPUTMETHOD_SWITCHKEY や IBMJAVA_INPUTMETHOD_SWITCHKEY_MODIFIERS 環境変数でなく、java.util.prefs.Preferences クラスを使用してください。詳細については、Sun の「Input Method Framework Specification」を参照してください。

# ユーザー・システムへのアプリケーションのインストール

プロダクトの開発を終えて出荷準備が整ったら、ユーザー・システムにプロダクトをインストールして、ソフトウェアをサポートするように構成し、Runtime Environment を構成する必要があります。

Runtime Environment for Linux を使用する場合、インストール手順で既存のインストール・プロダクトを上書きしないように気を付けてください (既存の Runtime Environment for Linux が古いバージョンでない限り)。

Runtime Environment for Linux を再配布するには、ご使用のシステムにそれをインストールしてから、必要な Runtime Environment ファイルをインストール・セットにコピーします。この方法をとる場合、Runtime Environment for Linux の全ファイルを組み込む必要があります 。Runtime Environment for Linux ソフトウェアは、すべてのファイルが組み込まれている場合に限って再配布することができます。その結果、アプリケーションは、出荷時にそれぞれ個別の Runtime Environment for Linux のコピーを含むことになります。

再配布する必要があるファイルに関する特定の情報については、製品に同梱されているご使用条件を参照してください。

# 既知の制限

以下のセクションでは Runtime Environment for Linux の既知の制約事項について説明します。

##

- K Desktop Environment (KDE) を実行中の場合には、Linux アプリケーションと Java アプリケーション間で情報をコピーするための 2 バイト文字セット (DBCS) を含むシステム・クリップボードが使用できない場合があります。
- SDK は Java スレッドをネイティブ・スレッドとして実装します。そのために、それぞれのスレッドが別個の Linux プロセスとなります。Java スレッドの数が許容される最大プロセス数を超えると、プログラムがエラー・メッセージ (SIGSEGV エラー) を出したりシステムがハングすることがあります。

  使用可能な最大スレッド数は、次のうちの最小値で決まります。

  - /etc/security/limits.conf のユーザー・プロセス数設定値 (ulimit -u)
  - /proc/sys/kernel/threads_max に定義されている限度
  - libpthreads.so に定義されている限度 PTHREAD_THREADS_MAX (変更した場合は glibc の再コンパイルが必要）

  ただし、最大スレッド数に達する前に仮想記憶域を使い尽くしてしまうこともあります。

- Ctrl-C を使用して Java アプリケーションを停止すると、いくつかのプロセスが孤立したまま残されることがあります。
- Swing を使って作成されたダイアログ・ボックスを表示しようとすると、これらのボックスがウィンドウに表示されるまでに数秒の遅れが生ずることがあります。
- ALT キーが含まれる KeyEvent の処理結果は、Linux で使用するウィンドウ・マネージャーによって異なります。また、他のオペレーティング・システムの結果とも異なります。Enlightenment ウィンドウ・マネージャーでは、 Alt+A キーおよび Shift+Alt+A キーはそれぞれ異なる修飾子を作成し、 Ctrl+Alt+ A キーはまったくキー・イベントを作成しません。ただし、WindowMaker ウィンドウ・マネージャーを使用すると、Ctrl+Alt+A でキー・イベントが作成されます。
- Linux X Window System では、キー・マップは 64 0xffe9 (Alt_L) 0xffe7 (Meta_L)、および 113 0xffea (Alt_R) 0xffe8 (Meta_R) に設定されます。 この設定を確認するには、シェル・プロンプトで次のように入力してください。

      xmodmap -pk

  これは、SDK が Meta + Alt が押されたと見なす原因になります。その対策として、シェル・プロンプトで次のように入力して Meta_x マッピングを除去することもできます。

      xmodmap -e "keysym Alt_L = Alt_L" -e "keysym Alt_R = Alt_R"

  注:
  この予備手段をとると、同じ画面で実行中の他の X-Window アプリケーションが除去対象の Meta キーを使用している場合に影響を受けることがあります。
- 一般的でない長さの DSA 鍵ペアの作成は、低速なマシンでは非常に長い時間を要します。時間の余裕が十分にある場合には、遅延をハングとして解釈せずに、プロセスが完了するまで待ってください。 DSA 鍵生成アルゴリズムは、標準でない鍵の長さの生成よりも、標準的な鍵の長さ (例えば 512 や 1024) の生成をより迅速に行うために最適化されます。
- JNI アプリケーションから JNI_CreateJavaVM() を呼び出した場合、セグメンテーション障害 (シグナル SIGSEGV) が発生することがあります。この障害を避けるには、-lpthread オプションを指定して JNI プログラムを再ビルドしてください。
- これは中国語 (繁体字) のユーザーへの情報です。中国語 (繁体字) 文字の入力に LinYi ZhuYin、YiTian ZhuYin、および Bosham IME を使用すると、ファンクション・キーの Enter、スペース、Backspace、および ESC が期待通りに機能しません。 Enter キーは改行を挿入し、ESC キーは事前編集ストリングや候補ウィンドウを取り消すために使用され、スペース・バーはスペースを挿入します。中国語 (繁体字) の入力に LinYi ZhuYin、YiTian ZhuYin、および Bosham IME を使用しているときにコミット・キーを押すと候補ウィンドウが消えて、Backspace キーを押しても表示されません。
- 多くの並行スレッドを実行している場合、警告メッセージ `java.lang.OutOfMemoryError` が出されることがあります。これは、マシンのシステム・リソースが使い尽くされていることを示しており、メッセージは以下の理由によって発生する可能性があります。
  1. 以下の理由で、新規スレッドを作成できない。
     - 作成されたプロセスの数がユーザー制限を超えている。
     - 新規スレッドを作成するために使用可能な十分なシステム・リソースがない。この場合、実行中のアプリケーションによっては、他の Java 例外も表示される可能性があります。
  2. カーネル・メモリーが使い尽くされたか、またはフラグメント化している。強制終了されたプロセス ID に対応する、メモリー不足を示すカーネル・メッセージを /var/log/messages で確認してください。
  システムをチューニングして、対応するシステム・リソースを増やしてください。
- Red Hat が配布したこの製品の前のバージョンがインストールされていると、インストール中に Red Hat Package Manager (RPM) は、IBM パッケージが Red Hat が配布した製品のバージョンよりも古いと報告します。この状態が生じるのは、Red Hat が「シリアル番号」を RPM パッケージに追加し、これがパッケージ中の製品バージョン管理方式をオーバーライドして、デフォルトでは、RPM がすでにインストールされている製品より古いと見なされるパッケージのインストールを拒否するからです。 rpm コマンドの --oldpackage オプションによって、新規の IBM パッケージをインストールすることができます。
- java awt/swing アプリケーションを Linux マシンで実行し、その表示を 2 番目のマシンにエクスポートするときに、X クライアント・マシンにロードしたフォントのセットが X サーバー・マシンにロードしたフォントのセットと異なる場合、一部のダイアログの表示で問題が発生する可能性があります。この問題は、特に、サーバー・バージョンのデフォルトのインストールでは英字フォントがインストールされるが、クライアントのデフォルトのインストールではインストールされない中国語のロケールの SLES8 で顕著です。この問題を回避するには、両方のマシンに同じフォントをインストールします。
- システム・ロケールが UTF-8 エンコード方式を使用している場合、一部の SDK ツールで sun.io.MalformedInputException がスローされる場合があります。システムが UTF-8 エンコード方式を使用しているかどうかを確認するには、LANG または LC_ALL などのロケール固有の環境変数を調べてその末尾が接尾部「.UTF-8」になっているか確認します。この sun.io.MalformedInputException が出されたら、7 ビット ASCII の範囲 (0x00 - 0x7f) 外にあり Java Unicode 文字リテラルとして表現されていない文字を Java Unicode 文字リテラル (例えば「¥u0080」) に変更します。また、ロケール固有の環境変数から「.UTF-8」接尾部を除去することによっても、この問題を回避することができます。例えば、ご使用のマシンのデフォルトのロケールが「en_US.UTF-8」である場合は、LANG を「en_US」に設定します。
- クロスプラットフォーム環境で AMI および xcin を使用している場合 (例えば、32 ビット・システムと 64 ビット・システム間、またはビッグ・エンディアン・システムとリトル・エンディアン・システム間で表示をエクスポートしようとする場合) に、問題が発生する可能性があります。この種の問題が発生したら、Linux のディストリビューターにお問い合わせください。
- Redhat Enterprise Linux 3.0 では、中国語 GB18030 ロケールの GB2312 文字を除いて、中国語の文字が AWT テキスト・コンポーネントで表示されない場合があります。

#

# 特記事項

本書は米国 IBM が提供する製品およびサービスについて作成したものです。本書に記載の製品、サービス、または機能が日本においては提供されていない場合があります。日本で利用可能な製品、サービス、および機能については、日本 IBM の営業担当員にお尋ねください。本書で IBM 製品、プログラム、またはサービスに言及していても、その IBM 製品、プログラム、またはサービスのみが使用可能であることを意味するものではありません。これらに代えて、IBM の知的所有権を侵害することのない、機能的に同等の製品、プログラム、またはサービスを使用することができます。ただし、IBM 以外の製品とプログラムの操作またはサービスの評価および検証は、お客様の責任で行っていただきます。

IBM は、本書に記載されている内容に関して特許権（特許出願中のものを含む）を保有している場合があります。本書の提供は、お客様にこれらの特許権について実施権を許諾することを意味するものではありません。実施権についてのお問い合わせは、書面にて下記宛先にお送りください。

- 〒106-0032
  東京都港区六本木 3-2-31
  IBM World Trade Asia Corporation
  Licensing

以下の保証は、国または地域の法律に沿わない場合は、適用されません。

IBM およびその直接または間接の子会社は、本書を特定物として現存するままの状態で提供し、商品性の保証、特定目的適合性の保証および法律上の瑕疵担保責任を含むすべての明示もしくは黙示の保証責任を負わないものとします。国または地域によっては、法律の強行規定により、保証責任の制限が禁じられる場合、強行規定の制限を受けるものとします。

この情報には、技術的に不適切な記述や誤植を含む場合があります。本書は定期的に見直され、必要な変更は本書の次版に組み込まれます。IBM は予告なしに、随時、この文書に記載されている製品またはプログラムに対して、改良または変更を行うことがあります。

本書において IBM 以外の Web サイトに言及している場合がありますが、便宜のため記載しただけであり、決してそれらの Web サイトを推奨するものではありません。それらの Web サイトにある資料は、この IBM 製品の資料の一部ではありません。それらの Web サイトは、お客様の責任でご使用ください。

IBM は、お客様が提供するいかなる情報も、お客様に対してなんら義務も負うことのない、自ら適切と信ずる方法で、使用もしくは配布することができるものとします。

本プログラムのライセンス保持者で、(i) 独自に作成したプログラムとその他のプログラム（本プログラムを含む）との間での情報交換、および (ii) 交換された情報の相互利用を可能にすることを目的として、本プログラムに関する情報を必要とする方は、下記に連絡してください。

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

本プログラムに関する上記の情報は、適切な使用条件の下で使用することができますが、有償の場合もあります。

本書で説明されているライセンス・プログラムまたはその他のライセンス資料は、IBM 所定のプログラム契約の契約条項、IBM プログラムのご使用条件、またはそれと同等の条項に基づいて、IBM より提供されます。

この文書に含まれるいかなるパフォーマンス・データも、管理環境下で決定されたものです。そのため、他の操作環境で得られた結果は、異なる可能性があります。一部の測定が、開発レベルのシステムで行われた可能性がありますが、その測定値が、一般に利用可能なシステムのものと同じである保証はありません。さらに、一部の測定値が、推定値である可能性があります。実際の結果は、異なる可能性があります。お客様は、お客様の特定の環境に適したデータを確かめる必要があります。

IBM 以外の製品に関する情報は、その製品の供給者、出版物、もしくはその他の公に利用可能なソースから入手したものです。IBM は、それらの製品のテストは行っておりません。したがって、他社製品に関する実行性、互換性、またはその他の要求については確証できません。 IBM 以外の製品の性能に関する質問は、それらの製品の供給者にお願いします。

## 商標

IBM は、IBM Corporation の商標です。

Java およびすべての Java 関連の商標およびロゴは、Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。

Linux は、Linus Torvalds の米国およびその他の国における商標です。

他の会社名、製品名およびサービス名などはそれぞれ各社の商標または登録商標です。

この製品には、Apache Software Foundation (http://www.apache.org/) によって開発されたソフトウェアが含まれています。