機能
JP1/IM - Managerのプロセスで障害が発生したときに,ダンプを出力するためのコマンドです。なお,セントラルスコープサービス(jcsmain)およびIM構成管理サービス(jcfmain)は除きます。また,jcogencoreコマンドを実行した場合は,JP1/IM - Managerを再起動する必要があります。
障害の検知手段としてはJP1/IM - Managerのヘルスチェック機能を利用します(ヘルスチェック機能については,マニュアル「JP1/Integrated Management - Manager 導入・設計ガイド」の「7.2 JP1/IM - Managerのヘルスチェック機能」参照)。
jcogencoreコマンドを実行すると,どのプロセスの障害資料を出力するか問い合わせメッセージが表示されます。障害が発生したプロセスの資料を出力するようにします。jcogencoreコマンドを実行することで出力されるファイルを次の表に示します。
表1-25 出力されるファイル
OS | プロセス名 | 出力されるファイルの名称 | |
---|---|---|---|
Javaスレッドダンプ | コアダンプ | ||
Windows | evflow | javacoreプロセスID.XXXXXXXXXX.txt | - |
jcamain | - | - | |
evtcon※1 | javacoreプロセスID.XXXXXXXXXX.txt | - | |
jcdmain※1 | javacoreプロセスID.XXXXXXXXXX.txt | - | |
evgen※1,※2 | javacoreプロセスID.XXXXXXXXXX.txt | - | |
UNIX | evflow | javacoreプロセスID.XXXXXXXXXX.txt※3 | core.evflow |
jcamain | - | core.jcamain | |
evtcon※1 | javacoreプロセスID.XXXXXXXXXX.txt※3 | core.evtcon | |
jcdmain※1 | javacoreプロセスID.XXXXXXXXXX.txt※3 | core.jcdmain | |
evgen※1,※2 | javacoreプロセスID.XXXXXXXXXX.txt※3 | core.evgen |
出力されたファイルは,次のフォルダに格納されます。
出力したスレッドダンプおよびコアダンプは,資料採取ツールを使って,ほかの障害資料と合わせて採取してください。
また,このコマンドを実行したあとは,JP1/IM - Managerの再起動が必要です。
形式
jcogencore [-h 論理ホスト名]
実行権限
Windowsの場合:Administrators権限(WindowsのUAC機能が有効な場合は管理者コンソールから実行)
UNIXの場合:スーパーユーザー権限
格納先ディレクトリ
Consoleパス¥bin¥
/opt/jp1cons/bin/
引数
-h 論理ホスト名
クラスタシステムで運用している場合に,論理ホスト名を指定します。指定した論理ホストのJP1/IM - Managerプロセスのスレッドダンプ,またはコアダンプを出力します。このオプションを省略した場合,環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合,物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。
注意事項
戻り値
0 | 正常終了 |
1 | オプション・引数解析エラー |
2 | プロセスチェックエラー |
3 | 論理ホストエラー |
4 | 実行権限エラー(Windows限定) |
5 | パイプ作成エラー(Windows限定) |
6 | スレッドダンプ出力処理エラー |
10 | その他のエラー |
使用例1
Windowsで,物理ホストのイベントコンソールサービス(java)プロセスがハングアップした場合
jcogencore
使用例2
Windowsで,論理ホストhostAのイベントコンソールサービス(java)プロセスがハングアップした場合
jcogencore -h hostA
使用例3
UNIXで,物理ホストのイベントコンソールサービス(java)プロセスがハングアップした場合
/opt/jp1cons/bin/jcogencore
出力例
UNIXで,物理ホストのイベントコンソールサービス(java)プロセスがハングアップし,コアダンプおよびスレッドダンプを出力する場合
ProcessName PID
[1] : evflow 1234
[2] : jcamain 94320
[3] : evtcon 3333
[4] : evgen 65654
[5] : jcdmain 368828
[6] : Exit
KAVB8427-I When outputting dumps for the three processes evflow, jcamain, and evtcon at the same time, output the dumps in order of evtcon, jcamain, and evflow.
KAVB8417-I Please enter a number for the process to output the core dump file [1-6]:3
KAVB8414-I The thread dump output request has been sent.
KAVB8407-I When the core dump is output, evtcon will stop. Is this OK? (y/n):y
KAVB8406-I The core dump file will be output.
KAVB8416-I The core dump file has been output.