jheapprof [-f|-i] [-class <クラス名>] -p <プロセスID>

引数に指定したプロセスIDのjavaプロセスに対して，日立クラス別統計情報を含んだ拡張スレッドダンプを出力します。

-f

-iオプションを無効にします。省略した場合，日立クラス別統計付き拡張スレッドダンプの出力処理の実行を確認するメッセージが表示されるので，yまたはnを入力します。このとき，yを入力すると日立クラス別統計付き拡張スレッドダンプが出力されます。nを入力すると，何もしないで処理を終了します。

-i

日立クラス別統計付き拡張スレッドダンプの出力処理の実行を確認するメッセージが表示されます。省略した場合，-fオプションが指定されないかぎり，このオプションは有効です。

-class <クラス名>

<クラス名>に指定したクラス（インスタンス）をメンバに持つクラスの構造を一覧にしてスレッドダンプ中に出力します。指定するクラスのパッケージ名は「"（ダブルクォーテーション）」で囲みます。

-p <プロセスID>

<プロセスID>には，日立クラス別統計情報を出力するjavaプログラムのプロセスIDを指定します。

0：

正常終了しました。

1：

異常終了しました。

2：

一定時間内に日立クラス別統計出力処理終了の応答がありませんでした。

1. -fオプションを省略してjheapprofコマンドを実行します。
   

   % jheapprof -p 2463

2. Windowsの場合，日立クラス別統計付き拡張スレッドダンプを出力するかどうかの確認メッセージが表示されます。UNIXの場合，プロセスIDの確認メッセージが表示されます。
   
   • Windowsの場合
     Force VM to output HitachiJavaHeapProfile: ? (y/n)
     
   • UNIXの場合
     send SIGQUIT to 2463: ? (y/n)
     
3. Windowsの場合，日立クラス別統計付き拡張スレッドダンプを出力する場合はyを，出力しない場合はnを入力します。UNIXの場合，SIGQUITシグナルを送信させる場合はyを，送信させない場合はnを入力します。
   
   • Windowsの場合
     Force VM to output HitachiJavaHeapProfile: ? (y/n)y
     
   • UNIXの場合
     send SIGQUIT to 2463: ? (y/n)y
     
4. 日立クラス別統計付き拡張スレッドダンプを出力すると，実行中のjavaプログラムでは次のメッセージが出力されます。
   

   Writing Java core to javacore2463.030806215140.txt... OK

5. 実行中のjavaプログラムは，カレントディレクトリに日立クラス別統計付き拡張スレッドダンプ（javacore<プロセスID>.<日時>.txt）を作成し，プログラムを継続します。

日立クラス別統計情報には，次の3種類の機能で出力した情報が存在します。

• インスタンス統計機能
• STATICメンバ統計機能
• クラス構造出力機能（-classオプションを指定した場合）

インスタンス統計機能

インスタンス統計機能では，classAのインスタンス→classAのメンバ変数（クラスはclassB）→classBのインスタンス→...とインスタンスの参照関係を調べ，ほかのインスタンスへの参照を持たないインスタンスのサイズをそのインスタンスをメンバに持つクラスに再帰的に加算します。つまり，インスタンス統計機能とは，各クラスのインスタンスがメンバとして持つインスタンスサイズの合計が出力される機能です。

次のソースを例にして説明します。

public class instance {
  public static void main(String args[]) {
    classA cls_a = new classA();
    try {
      Thread.sleep(20000);
    } catch (Exception e) {}
  }
}
class classA {
  classB a1;
  classC a2;
  classA() {
    a1 = new classB();
    a2 = new classC();
  }
}
class classB {
  classD b1;
  String b2;
  classB() {
    b1 = new classD();
    b2 = null;
  }
}
class classC {
  String c1, c2;
  classC() {
    c1 = null;
    c2 = null;
  }
}
class classD {
  String d1, d2;
  classD() {
    d1 = null;
    d2 = null;
  }
}

上記のソースの場合，次のようなインスタンス構造になっています。

このようなインスタンス構造の場合，インスタンス統計機能では，次のように各クラスのサイズを加算します。

• classAのサイズ：a1+a2+ b1+b2+ c1+c2+ d1+d2
• classBのサイズ：b1+b2+ d1+d2
• classCのサイズ：c1+c2
• classDのサイズ：d1+d2

したがって，出力結果は次のようになります。

STATICメンバ統計機能

STATICメンバ統計機能もインスタンス統計機能と同様に，インスタンスの参照関係を調べ，そのサイズを加算して統計情報を出力します。インスタンス統計機能と異なる点は，インスタンス統計機能が最初に取り出したインスタンスの非staticフィールドから参照関係を構築するのに対し，STATICメンバ統計機能は最初に取り出したインスタンスのstaticフィールド(=クラスのstaticフィールド)から参照関係を調べるという点です。これによって，各クラスのstaticメンバが持つインスタンスの合計サイズを得ることができます。ただし，最初に取り出すインスタンス以外では，インスタンス統計機能／STATICメンバ統計機能共に，インスタンスの非staticメンバを基に参照関係を調べます。

インスタンス統計機能とSTATICメンバ統計機能の違いを次のソースを例にして説明します。

public class static_instance {
  public static void main(String args[]) {
    classA cls_a;
    classB cls_b;
    classC cls_c;
 
    cls_a = new classA();
    cls_b = new classB();
    cls_c = new classC();
    cls_b.cls_c = cls_c;
    cls_a.cls_b = cls_b;
 
    try {
      Thread.sleep(20000);
    } catch (Exception e) {}
  }
}
class classA {
  static classB cls_b;
}
class classB {
  classC cls_c;
}
class classC {
}

上記のソースの場合，インスタンス統計機能とSTATICメンバ統計機能では，次のような違いがあります。

上の図でインスタンス統計機能の参照関係は次のようになります。

インスタンスAのインスタンス変数 cls_b → インスタンスBのインスタンス変数 cls_c → インスタンスC

一方，STATICメンバ統計機能の参照関係は次のようになります。

クラスAのクラス変数cls_b → インスタンスBのインスタンス変数cls_c → インスタンスC

STATICメンバ統計機能での出力結果を次に示します。

クラス構造出力機能

jheapprofコマンドに-classオプションを指定することで，指定したクラス（インスタンス）をメンバに持つクラスの構造を一覧にしてスレッドダンプ中に出力できます。

指定したクラスのインスタンスが複数ある場合は，該当するすべてのインスタンスが出力されます。同じ名前のインスタンスが複数ある場合でも，インスタンス名のあとに，そのインスタンスのアドレスが出力されるため，別のインスタンスかどうか識別できます。

次のソースを例にして説明します。

public class instance2 {
  public static void main(String args[]) {
    classA cls_a1 = new classA();    classA cls_a2 = new classA();
    classB cls_b1 = new classB();    classB cls_b2 = new classB();
    classC cls_c1 = new classC();    classC cls_c2 = new classC();
    classC cls_c3 = new classC();    classC cls_c4 = new classC();
    cls_a1.cls_a = cls_a2;    cls_a1.cls_b = cls_b1;
    cls_a1.cls_c = cls_c1;    cls_a2.cls_b = cls_b2;
    cls_b1.cls_c = cls_c2;    cls_b2.cls_c = cls_c3;
    cls_c1.cls_c = cls_c4;
    try {
      Thread.sleep(20000);
    } catch (Exception e) {}
  }
}
class classA {
  classA cls_a;
  classB cls_b;
  classC cls_c;
 
  classA() {
    classB cls_b;
  }
}
class classB {
  classC cls_c;
}
class classC {
  classC cls_c;
}

上記のソースの場合，次のようなインスタンス構造になっています。

jheapprofコマンドに引数「-class <クラス名>」を指定した場合，出力結果は次のようになります。

（　）内はインスタンスのメモリ上のアドレスです。classAのアドレスはすべて同じアドレスになっています。したがって，classAはすべて同じインスタンスであることがわかります。一方，（1）と（4）のclassBはアドレスが異なっているので別のインスタンスであることがわかります。

なお，ガーベージコレクションの発生によってインスタンスのメモリ上の配置が変化します。そのため，出力するたびにアドレスが変化する場合があります。

次のエラーメッセージまたは警告メッセージが出力された場合，日立クラス別統計付き拡張スレッドダンプは出力されません。

表7-7　jheapprofコマンドで出力されるメッセージ（Windowsの場合）

表7-8　jheapprofコマンドで出力されるメッセージ（UNIXの場合）

• jheapprofコマンドは，前回のjheapprofコマンドによるクラス別統計情報が拡張スレッドダンプに出力されたあとに実行してください。
• Windowsの場合，Javaプロセスは起動時にMailSlotを使った通信の初期化処理が必要ですが，初期化に失敗した場合もメッセージが表示され，処理が中断されます。
• UNIXの場合，引数に指定したプロセスIDのjavaプロセスオーナーでないユーザがこのコマンドを実行するとメッセージが出力され，処理が終了します。ユーザがrootである場合は，処理を継続します。
• Windowsの場合，引数に指定したプロセスIDのjavaプロセス所有者以外でもjheapprofコマンドを実行できます。
• UNIXの場合，jheapprofコマンドは，SIGQUITシグナルを指定されたプロセスに送信します。誤ってjavaプログラム以外を指定すると，ほかのプログラムが停止することがあります。
• UNIXの場合，jheapprofコマンド実行時に，/tmp/hsperfdata_<ユーザ名>/<プロセスID>ファイルを使用します。該当するファイルが存在しない場合，jheapprofコマンドによるクラス別統計情報出力はできません。
• jheapprofコマンドはプログラムの開発用ユーティリティとして提供されているものです。システムの運用では使用しないでください。