19.5 Cosminexusで指定できるJava HotSpot VMのオプション

ここでは,add.jvm.argに指定できるJava HotSpot VMのオプションについて説明します。

add.jvm.argに指定できるJava HotSpot VMのオプションについて次の表に示します。なお,「VR」とは,パラメタが導入・変更されたアプリケーションサーバのバージョンです。

表19-11 add.jvm.argを指定した場合に指定できるJava HotSpot VMのオプション

オプション名内容指定可能値VR
-D<property>JavaVMのシステムプロパティを指定します。入力は制限されません。05-00
-agentlib:<libname>[=<options>]ネイティブエージェントライブラリ<libname>をロードします。入力は制限されません。08-00
-verbose:<情報種別><情報種別>に指定した情報を出力します。<情報種別>に指定できる値を示します。
class:
クラスがロードされるたびにクラスに関する情報を出力します。
gc:
ガベージコレクションイベントが発生するたびに報告します。
jni:
ネイティブメソッドの使用およびそのほかのJava Native Interface(JNI)アクティビティに関する情報を報告します。
指定できる文字列を次に示します。
  • class
  • gc
  • jni
05-00
-Xloggc:<ファイル>-verbose:gcと同様にガベージコレクションイベントが発生するたびに報告しますが,そのデータを<ファイル>に記録します。-verbose:gcを指定したときに報告される情報のほかに,報告される各イベントの先頭に,最初のガベージコレクションイベントからの経過時間(秒単位)が付け加えられます。入力は制限されません。05-00
-Xms<size>Javaヒープの初期サイズを設定します。0~9の数値を,次に示す単位を使って指定します。
  • キロ「k」
  • メガ「m」
  • ギガ「g」
  • テラ「t」
なお,大文字・小文字は区別されません。
05-00
-Xmx<size>Javaヒープの最大サイズを設定します。0~9の数値を,次に示す単位を使って指定します。
  • キロ「k」
  • メガ「m」
  • ギガ「g」
  • テラ「t」
なお,大文字・小文字は区別されません。
05-00
-Xmn<size>DefNew領域の初期値および最大値を設定します。0~9の数値を,次に示す単位を使って指定します。
  • キロ「k」
  • メガ「m」
  • ギガ「g」
  • テラ「t」
なお,大文字・小文字は区別されません。
05-00
-Xss<size>1スタック領域の最大サイズを設定します。0~9の数値を,次に示す単位を使って指定します。
  • キロ「k」
  • メガ「m」
  • ギガ「g」
  • テラ「t」
なお,大文字・小文字は区別されません。
05-00
-Xprofこのオプションを指定した場合,実行中のプログラムのプロファイルを生成し,プロファイリングデータを標準出力に出力します。このオプションは,プログラム開発用のユーティリティとして提供されています。本番稼働システムでの使用を目的としたものではありません。05-00
-Xrunhprof[:<suboption>=<value>,...]CPU,ヒープ,またはモニタのプロファイリングを有効にします。-Xrunhprofの後ろにコロン「:」を指定して「<suboption>=<value>」を記述します。「<suboption>=<value>」はコンマ「,」で区切って複数指定できます。
サブオプションとそのデフォルト値のリストを取得するには,コマンドjava-Xrunhprof:helpを実行します。
任意の文字列を指定します。
<suboption>には「=」および「,」は指定できません。
また,<value>には「,」は指定できません。
05-00
-Xrun<libraryName>JVMPI,JVMDIなどのエージェントを含むライブラリと,起動時に渡されるオプションの文字列を指定します。入力は制限されません。05-00
-Xdebug指定した場合,JVMDIのサポートを有効にして開始します。JVMDIは推奨されていません。また,J2SE 5.0でのデバッグには使用されません。したがって,J2SE 5.0でのデバッグには,このオプションは必要ありません。05-00
-XX:NewRatio=<value>DefNew領域に対するTenured領域の割合を指定します。0~9の数値を,次に示す単位を使って指定します。
  • キロ「k」
  • メガ「m」
  • ギガ「g」
  • テラ「t」
なお,大文字・小文字は区別されません。
05-00
-XX:PermSize=<size>Permanent領域の初期サイズを指定します。0~9の数値を,次に示す単位を使って指定します。
  • キロ「k」
  • メガ「m」
  • ギガ「g」
  • テラ「t」
なお,大文字・小文字は区別されません。
05-00
-XX:MaxPermSize=<size>Permanent領域の最大サイズを指定します。0~9の数値を,次に示す単位を使って指定します。
  • キロ「k」
  • メガ「m」
  • ギガ「g」
  • テラ「t」
なお,大文字・小文字は区別されません。
05-00
-XX:SurvivorRatio=<value>DefNew::Survivor領域のFrom空間とTo空間に対するDefNew::Eden領域の割合を指定します。0~9の数値を,次に示す単位を使って指定します。
  • キロ「k」
  • メガ「m」
  • ギガ「g」
  • テラ「t」
なお,大文字・小文字は区別されません。
05-00
-XX:[+|-]PrintTenuringDistribution
-XX:+PrintTenuringDistribution
コピーガーベージコレクション実行時に,Survivor領域のオブジェクトの年齢分布を出力します。
-XX:-PrintTenuringDistribution
コピーガーベージコレクション実行時に,Survivor領域のオブジェクトの年齢分布を出力しません。
指定できる文字を次に示します。
  • プラス「+」
  • マイナス「-」
05-00
-XX:TargetSurvivorRatio=<value>ガーベージコレクション実行後のDefNew::Survivor領域内でJavaオブジェクトが占める割合の目標値を指定します。0~9の数値を,次に示す単位を使って指定します。
  • キロ「k」
  • メガ「m」
  • ギガ「g」
  • テラ「t」
なお,大文字・小文字は区別されません。
05-00
-XX:MaxTenuringThreshold=<value>コピーガーベージコレクション実行時に,From空間とTo空間でJavaオブジェクトを入れ替える回数のしきい値を指定します。指定した回数を超えて入れ替え対象になったJavaオブジェクトは,Tenured領域に移動されます。0~9の数値を,次に示す単位を使って指定します。
  • キロ「k」
  • メガ「m」
  • ギガ「g」
  • テラ「t」
なお,大文字・小文字は区別されません。
05-00
-XrunhndlwrapJDKのバージョンが5以下の環境でWindowsをログオフしたとき,JavaVMの実行を継続するかどうか設定します。
-XX:+EagerXrunInitを指定した場合,このオプションの指定は無効になります。また,-agentlib:hndlwrap2
を設定した場合,このオプションは設定しないでください。
このオプションは,ほかのJVMTI版プログラムと同時に使用できません。
コマンドプロンプト上でこのオプションを使用したJavaを実行している状態でログオフすると,「プログラムが反応しない」旨のエラーポップアップが表示され,ログオフできません。
05-01
-agentlib:hndlwrap2JDKのバージョンが6の環境でWindowsをログオフしたとき,JavaVMの実行を継続するかどうか設定します。
-Xrunhndlwrapを設定した場合,このオプションは設定しないでください。
このオプションは,ほかのJVMTIプログラムと同時に使用できません。
コマンドプロンプト上でこのオプションを使用したJavaを実行している状態でログオフすると,「プログラムが反応しない」旨のエラーポップアップが表示され,ログオフできません。
08-50

(凡例)-:該当なし


ポイント
Java HotSpot VMのオプションのデフォルト値は,サーバごとに参照先が異なります。サーバ,およびアプリケーションごとのJava HotSpot VMのオプションのデフォルト値の参照先を次の表に示します。

表19-12 サーバ,およびアプリケーションごとのJava HotSpot VMのオプションのデフォルト値の参照先

使用するサーバおよびアプリケーション参照先
J2EEサーバ2.3 usrconf.cfg(J2EEサーバ用オプション定義ファイル)
バッチサーバ3.2 usrconf.cfg(バッチサーバ用オプション定義ファイル)
Webコンテナサーバ18.3 usrconf.cfg(Webコンテナサーバ用オプション定義ファイル)
cjclstartapコマンドで起動するJavaアプリケーション15.2 usrconf.cfg(Javaアプリケーション用オプション定義ファイル)
そのほかのJavaアプリケーション19.4 Cosminexusで指定できるJava HotSpot VMのオプションのデフォルト値
なお,Java HotSpot VMのオプションを簡易構築定義ファイルに指定する場合は,「param-name指定値」にadd.jvm.argを指定した場合に指定できる「param-valueの指定内容」にJava HotSpot VMのオプションを指定してください。