トラブルシューティング用の DIAGNOSE ユーティリティー
DIAGNOSE ユーティリティーにより、Db2® サービス担当員は、ユーティリティーを使用した問題の診断が可能になります。 TYPE パラメーターを使用して、最大 32 個のアクティビティーをモニターすることができます。 これらのアクティビティーは、サービス担当員によって必要に応じて定義されます。
DIAGNOSE を使用して、以下のことを行うこともできます。
- ユーティリティー異常終了のダンプを取得し、そのようなダンプを抑止する可能性がある考慮事項を解消する
- OBD および SYSUTIL の情報を確認のために SYSPRINT に送信する (DISPLAY オプション)
- SVC ダンプを強制せずに、Db2 MEPL およびアプリケーション・スペース (DSNUTILB) MEPL の両方を SYSPRINT にダンプする (DISPLAY MEPL オプション)
- SYSIBM.SYSDATABASE 内のデータベースの項目を SYSPRINT にダンプする (DISPLAY オプション)
- 特定の Db2 メッセージが指定された後、あるいはモジュール・トレース ID が発生した場合に、強制的に Db2 を異常終了させる (ABEND オプションと MESSAGE オプションまたは TRACEID オプションの連携)
構文図の診断
>>-DIAGNOSE--+-diagnose statement-+---------------------------->< '-END----------------'
diagnose statement:
>>-+---------------------+--------------------------------------> | .-,-------. | | V | | '-TYPE(---integer-+-)-' >--+------------------------------------+-----------------------> '-ALLDUMPS-+-----------------------+-' | .-,-------------. | | V | | '-(---X'abend-code'-+-)-' >--+-----------------------------------+------------------------> '-NODUMPS-+-----------------------+-' | .-,-------------. | | V | | '-(---X'abend-code'-+-)-' >--+----------------+--+-------------------+--+-----------------+->< '-wait statement-' '-display statement-' '-abend statement-'
wait statement:
.-.----------------. V | >>-WAIT----+-message spec-+-+---------------------------------->< '-traceid spec-'
abend statement:
display statement:
>>-DISPLAY------------------------------------------------------> >--+-OBD-+----------------+-table-space-name-+---------+-----+->< | '-database-name.-' +-ALL-----+ | | +-TABLES--+ | | '-INDEXES-' | +-SYSUTIL-------------------------------------------------+ +-MEPL----------------------------------------------------+ '-DBET-+-DATABASE--database-name------------------------+-' +-TABLESPACE-+----------------+-table-space-name-+ | '-database-name.-' | '-INDEX--index-name------------------------------'
message spec:
traceid spec:
>>-TRACEID--+-X'trace-id'-+--+-------------------+------------->< '-integer-----' '-INSTANCE--integer-'
キーワードおよびパラメーターの説明
- TYPE(integer, …)
- 実行する 1 つ以上の診断タイプを指定します。
integer は、診断タイプの数です。 タイプの最大数は 32 です。
- ALLDUMPS(X'abend-code', …)
- ユーティリティー異常終了コードから強制的にダンプを取得します。
X'abend-code' は、異常終了コードのリストのメンバーです。ALLDUMPS の適用範囲はこのリストに制限されます。 ALLDUMPS の適用範囲の制限はオプションです。
abend-code は 16 進値です。
- NODUMPS(X'abend-code', …)
- 任意のユーティリティー異常終了コードのダンプを抑止します。
X'abend-code' は、異常終了コードのリストのメンバーです。NODUMPS の適用範囲はこのリストに制限されます。 NODUMPS の適用範囲の制限はオプションです。
abend-code は 16 進値です。
- END
- DIAGNOSE 処理を終了します。
- WAIT
- 指定のユーティリティー・メッセージもしくはユーティリティー・トレース ID が検出されると、コンソールにメッセージが出され、ユーティリティーの実行は、オペレーターがそのメッセージに応答するか、ユーティリティー・ジョブがタイムアウトになるか、あるいはユーティリティー・ジョブが取り消されるまで延期されます。
これにより、並行性問題の診断中にイベントを同期化させることができます。
ユーティリティーは、オペレーターがメッセージに応答するまで待機し、イベントの時刻調整や同期化を可能にします。
ユーティリティー・メッセージとトレース ID のどちらも見つからない場合は、WAIT 処理が続行されます。
- ABEND
- 指定のユーティリティー・メッセージまたはユーティリティー・トレース ID が検出されると、実行中のユーティリティーが強制的に異常終了されます。
ユーティリティー・メッセージとトレース ID のどちらも見つからない場合は、ABEND 処理が続行されます。
- NODUMP
- DIAGNOSE の異常終了によって生成されるダンプを抑止します。
- DISPLAY
- 指定されたデータベース・エンティティーが、SYSPRINT を使用してフォーマットされることを示します。
- OBD database-name.table-space-name
- 指定された表スペースのオブジェクト記述子 (OBD) が SYSPRINT にフォーマットされることを指定します。
database-name は、表スペースが属しているデータベースの名前です。
table-space-name は、OBD がフォーマット設定される表スペースの名前です。- ALL
- 指定された表スペースのすべての OBD が SYSPRINT でフォーマットされることを指定します。 表スペースに関連するすべての関係の OBD もフォーマットされます。
- TABLES
- 指定された表スペース内のすべての表の OBD が SYSPRINT にフォーマットされることを指定します。
- INDEXES
- 指定された表スペース内のすべての索引の OBD が SYSPRINT にフォーマットされることを指定します。
- SYSUTIL
- すべての SYSUTIL レコードが SYSPRINT にフォーマットされることを指定します。
- MEPL
- モジュール入り口点リスト (MEPL) が SYSPRINT にダンプされることを示します。
- DBET
- データベース例外表 (DBET) の表項目のコンテンツが SYSPRINT にダンプされることを示します。
このオプションは、IBM® サポート・センターに指示された場合にのみ使用してください。
- DATABASE database-name
- 指定されたデータベースに関連する DBA 表項目が SYSPRINT にダンプされることを示します。
database-name は、データベースの名前です。
- TABLESPACE database-name.table-space-name
- 指定された表スペースに関連する DBA 表項目が SYSPRINT にダンプされることを示します。
database-name は、データベースの名前です。
table-space-name は、SYSPRINT にダンプされる表スペースの名前です。
- INDEX creator-name.index-name
- 指定された索引に関連する DBA 表項目が SYSPRINT にダンプされることを示します。
creator-name は、索引の作成者の ID です。
index-name は、SYSPRINT にダンプされる索引の名前です。
- MESSAGE message-id
- メッセージの発行時に待機または異常終了が発生する原因となる DSNUxxx メッセージまたは DSNUxxxx メッセージを指定します。
message-id は、Uxxx または Uxxxx の形式 (メッセージ番号の長さによって変わります) のメッセージ ID です。
- INSTANCE integer
- MESSAGE オプション・メッセージの検出が指定された回数に達すると、待機または異常終了が発生することを指定します。
INSTANCE を指定しないと、メッセージが検出されるたびに待機または異常終了が発生します。
integer は、待機または異常終了が発生するまでに許容されるメッセージの検出回数です。
- TRACEID trace-id
- ID が検出されると待機または異常終了が発生する原因となるトレース ID を指定します。
有効なトレース ID は、データ・セット prefix.SDSNSAMP(DSNWEIDS) で見つけることができます。
trace-id は、ユーティリティー・トレース (RMID21) に関連するトレース ID で、10 進 (integer) または 16 進 (trace-id') のどちらで指定することもできます。
- INSTANCE integer
- TRACEID オプションの検出が指定された回数に達すると、待機または異常終了が発生することを指定します。
INSTANCE を指定しないと、トレース ID が検出されるたびに待機または異常終了が発生します。
integer は、待機または異常終了が発生するまでに許容されるトレース ID の検出回数です。
