形式
ajs2collectcore
[-b]
[-c]
[-f 出力パス名]
[-l]
[-s]
[コアダンプがあるディレクトリまたはコアダンプファイル...]
機能
次に示すディレクトリ配下にあるコアダンプファイル(ファイル名:core,core-,およびcore.で始まるファイル)を探索し,見つかったコアダンプファイルに対する解析情報を採取します。
ajs2collectcoreコマンドで採取できる情報を次の表に示します。
表2-1 ajs2collectcoreコマンドで採取できる情報
採取情報 | 内容 | 出力ファイル名※1 |
---|---|---|
コアダンプ | コアダンプファイル(core)の取得 | core.Z |
バックトレース情報 | コアダンプに対する一次解析情報の出力 | coreinfo.backtrace.Z※2 |
共有メモリー情報 | ISAMおよびスケジューラーサービスが使用する共有メモリーの内容を出力 | coreinfo-ISAM.shmdump.tar.Z coreinfo-scheduler.shmdump.Z |
共有ライブラリー情報 | 次のディレクトリ以外にある共有ライブラリー情報の取得
| coreinfo-analyze.tar.Z※2 |
採取されたファイルは,出力先ディレクトリ(デフォルトは/tmp/jp1ajs2/core_analyze/)の下に次の例に示すように出力されます。
/tmp/jp1ajs2/core_analyze/opt/jp1ajs2/bin/
また,採取した情報のファイルリストも同時に出力されます。ファイルリストは出力先ディレクトリの直下に出力されます。ファイル名は次のとおりです。
Ajs2collectcore_filelist.log
実行権限
スーパーユーザー権限
格納先ディレクトリ
/opt/jp1ajs2/tools/
引数
-b
採取対象となるコアダンプファイルのバックトレース情報だけを採取します。
-c,-l,または-sオプションと同時に指定することで,バックトレース情報以外の情報も合わせた部分採取ができます。-c,-l,または-sオプションが指定され,このオプションを省略した場合は,バックトレース情報は採取されません。
-c
採取対象となるコアダンプファイルだけを採取します。
-b,-l,または-sオプションと同時に指定することで,コアダンプファイル以外の情報も合わせた部分採取ができます。-b,-l,または-sオプションが指定され,このオプションを省略した場合は,コアダンプファイルは採取されません。
-f 出力パス名
採取するコアダンプ情報の格納先を,空白文字を含まない絶対パスで指定します。相対パスで指定した場合,このコマンドは引数エラーで異常終了します。また,指定したパス名に空白文字が含まれている場合,空白文字直前までの文字列が出力パス名とされ,空白文字以降の文字列は別の引数と見なされます。
このオプションを指定した場合,出力パスの配下にコアダンプ情報が格納されます。指定した出力パスがない場合は,ディレクトリ作成確認のメッセージが出力されます。このとき「y」を入力するとディレクトリが作成されます。「n」を入力すると,情報は採取されません。
省略した場合,「/tmp/jp1ajs2/core_analyze」が仮定されます。
-l
採取対象となるJP1/AJS3で提供しているライブラリー以外の共有ライブラリー情報だけを採取します。
-b,-c,または-sオプションと同時に指定することで,共有ライブラリー情報以外の情報も合わせた部分採取ができます。-b,-c,または-sオプションが指定され,このオプションを省略した場合は,共有ライブラリー情報は採取されません。
-s
採取対象となる共有メモリー情報だけを採取します。
このとき,出力先ディレクトリ直下にcoreinfo-ISAM.shmdump_*,またはcoreinfo-Scheduler.shmdump_*がある場合,ファイルの末尾に「.bk」を付けて退避します。
-b,-c,または-lオプションと同時に指定することで,共有メモリー情報以外の情報も合わせた部分採取ができます。-b,-c,または-lオプションが指定され,このオプションを省略した場合は,共有メモリー情報は採取されません。
コアダンプがあるディレクトリまたはコアダンプファイル
標準で採取対象となるコアダンプの探索パス配下(「機能」を参照)以外の,追加探索したいコアダンプのディレクトリパス,またはファイル名を,空白文字を含まない絶対パスで指定します。相対パスで指定した場合,このコマンドは引数エラーで異常終了します。また,指定したパス名に空白文字が含まれている場合,空白文字直前までの文字列が出力パス名とされ,空白文字以降の文字列は別の引数と見なされます。
探索パス内にコアダンプ(ファイル名:core,core-,およびcore.で始まるファイル)があれば,バックトレース情報および共有ライブラリー情報を取得します。
コアダンプがあるディレクトリまたはコアダンプファイルを指定しない場合,次のディレクトリ下のコアダンプを検索します。
注意事項
戻り値
0 | すべての資料採取成功。 |
4 | 一部の資料採取成功。 |
上記以外の値 | 異常終了。 |
出力メッセージ
戻り値 | 出力メッセージ | 意味 | 動作 | 対処方法 |
---|---|---|---|---|
0 | Collection of the backtrace data [ ファイル名 ] was successful. OutputPath: 出力パス名 | 正常採取(バックトレース)。 | 正常終了または次の取得情報へ継続。 | - |
0 | Collection of the core dump file [ ファイル名 ] was successful. OutputPath: 出力パス名 | 正常採取(コアダンプファイル)。 | 正常終了または次の取得情報へ継続。 | - |
0 | Collection of the shared library data [ ファイル名 ] was successful. OutputPath: 出力パス名 | 正常採取(ライブラリー情報)。 | 正常終了または次の取得情報へ継続。 | - |
0 | Collection of the {ISAM | Scheduler} shared memory dump was successful. Output Path: 出力パス名 | 正常採取(共有メモリー情報)。 | 正常終了または次の取得情報へ継続。 | - |
4または 8 | Error!!The input parameter [ 引数 ] is invalid. << ### Usage ### >> ajs2collectcore [ -b ] [ -c ] [ -l ] [ -s ] [ -f Output_fullpath ] [ Additional_search_fullpath ... ] | パラメーターエラー。 | 異常終了または処理続行(追加パス指定誤りの場合)。 | 必要なパラメーターを確認し,再実行してください。 |
16 | Error!! The specified directory [ 出力先ディレクトリ ] could not be created. | 出力先ディレクトリの作成不可。 | 異常終了。 | 出力先ディスク容量がいっぱいになっているおそれがあります。 出力先のディスク容量を確認し,改善したあと,再実行してください。 |
4または 8 | Error!! The specified file [ ファイル名 ] does not have overwrite permissions. | 既存ファイルへの上書き不可。 | 処理続行(対象となるファイル以外の採取を継続)。 | 対象となるファイルへの書き込み権限を与えて,再実行してください。 |
4または 8 | Error!! The backtrace data for the core dump file could not be collected. Corefile: 対応するコアダンプファイル名 | バックトレース情報の採取不可。 | 処理続行(対象となるバックトレース情報以外の採取を継続)。 | 出力先ディスク容量がいっぱいになっているおそれがあります。 出力先のディスク容量を確認し,改善したあと,再実行してください。 |
4または 8 | Error!! The core dump file could not be collected. Corefile: 対応するコアダンプファイル名 | コアダンプファイルの採取不可。 | 処理続行(対象となるコアダンプファイル以外の採取を継続)。 | |
4または 8 | Error!! Shared library data for the core dump file could not be collected. Corefile: 対応するコアダンプファイル名 | 共有ライブラリー情報の採取不可。 | 処理続行(対象となる共有ライブラリー情報以外の採取を継続)。 | |
4または 8 | Error!! {ISAM | Scheduler} shared memory data could not be collected. | 共有メモリー情報の採取不可。 | 処理続行(対象となる共有メモリー情報以外の採取を継続)。 | 次のエラーが考えられます。
|
4,8,または124 | An error occurred!! ErrorCause:[ エラー要因] ErrorInfo:[エラー情報] | その他のエラー。 | 処理続行(対象となる情報以外を採取)。 | - |
- | There are no core dump files in default directories. | 標準探索パスで何もコアダンプがないとき。 | - | - |
- | There are no core dump files in the specified path. | 追加指定パスで何もコアダンプがないとき。 | - | - |