DSNWDMP ステートメントを使用したダンプのフォーマット
DSNWDMP ステートメントを使用して、入力データとして使用するダンプ・レコードを指定し、Db2® ダンプ・フォーマッター (DSNWDPRD) が呼び出されるようにすることができます。このダンプ・フォーマッターは、指定された Db2 制御ブロックをフォーマットします。
DSNWDMP 制御ステートメントのパラメーターを変更することで、ダンプ内の Db2 制御ブロックをフォーマットします。 以下の図は、この制御ステートメントのフォーマットと指定できるオプションを示しています。
.-SUMDUMP=YES-+--------------+-. | '-,SUBSYS=nnnn-' | >>-DSNWDMP--+------------------------------+--+------------+----> '-,SUMDUMP=NO-,SUBSYS=nnnn-----' '-,-+-TT---+-' +-TT=1-+ +-TT=2-+ '-TT=3-' >--+-----+--+----------+--+-----+--+------+---------------------> '-,AA-' '-,SA=asid-' '-,LG-' '-,ALL-' >--+---------------------+------------------------------------->< '-,-+-ds-options----+-' +-sm-options----+ +-st-options----+ +-dm-options----+ +-bm-options----+ +-sh-options----+ +-db-options----+ +-et-options----+ +-di-options----+ +-disys-options-+ +-rs-options----+ '-sp-options----'
>>-+---------------------------------------------+------------->< '-+-DS=1-+-+------------+-+-----------------+-' +-DS=2-+ '-,-+-LM=1-+-' '-,TOKEN=xxxxxxxx-' +-DS=3-+ +-LM=2-+ '-DS=4-' '-LM=3-'
>>-+-------------------------------------------+--------------->< '-+-SM=1-+-+------------+-+---------------+-' +-SM=2-+ '-,SMSA=asid-' '-,PHB=phb-addr-' +-SM=3-+ +-SM=4-+ +-SM=5-+ '-SM=6-'
>>-+------+---------------------------------------------------->< +-ST=1-+ +-ST=2-+ '-ST=3-'
>>-+---------------------------+------------------------------->< '-+-DM=1-+-+--------------+-' '-DM=2-' '-,CT=xxxxxxxx-'
>>-+-------------------------------------------------------+--->< '-+-BM=1----------------------------------------------+-' +-BM=2----------------------------------------------+ '-BM=3-+------------+-+---------------------------+-' '-,BBIP=vvvv-' '-,DBID=yyyy-+------------+-' '-,OBID=zzzz-'
>>-+----------+------------------------------------------------>< '-+-SH=1-+-' +-SH=2-+ +-SH=3-+ +-SH=4-+ '-SH=5-'
>>-+-------------------------------------------------+--------->< '-+-DB=1-+------------+--------+-+--------------+-' | '-,DBID=yyyy-' | '-,CT=xxxxxxxx-' +-DB=2-+------------+--------+ | '-,DBID=yyyy-' | +-DB=3-+------------+--------+ | '-,DBID=yyyy-' | +-DB=4-,DBID=yyyy-,OBID=zzzz-+ '-DB=5-,DBID=yyyy-,OBID=zzzz-'
>>-+--------------------------+-------------------------------->< '-+-DI=1-+-,TOKEN=xxxxxxxx-' '-DI=2-'
rs-options:>>-+-------------+--------------------------------------------->< '---DISYS=1---'
sp-options:>>-+----------+------------------------------------------------>< '-+-RS=1-+-' '-RS=2-'
>>-+----------+------------------------------------------------>< '-+-SP=1-+-' +-SP=2-+ '-SP=3-'
複数のオペランドは、ブランクではなくコンマで区切ります。制御ステートメントでは、オペランドの後ろにブランクがあると、そこでオペランド・リストが終わると見なされ、後続のオペランドは無視されます。 以下の表は、ダンプをフォーマットするために Db2 制御ステートメントで指定することができるさまざまなキーワードをリストおよび説明しています。
| キーワード | 説明 |
|---|---|
| SUBSYS= nnnn | サイト定義の Db2 サブシステム名 (nnnn) を指定します。
範囲は、1 文字から 4 文字です。 SUMDUMP=YES の場合はオプション、SUMDUMP=NO の場合は必須です。 詳しくは、SUMDUMP 情報 を参照してください。 |
| TT | Db2 グローバル・トレース表をフォーマットします。
|
| AA | サブシステムのすべてのアクティブ・アドレス・スペース内の重要な Db2 制御ブロックをフォーマットします。 |
| SA | 単一アドレス・スペースに関連付けられた重要な Db2 制御ブロックをフォーマットします。 制御ステートメントは、ASID を 16 進 (最大 4 桁) で指定する必要があります。 アポストロフィおよび先行ゼロは、含めることも省略することもできます (例えば、DE、00DE、または '00DE' のようになります)。 |
| LG | 重要な Db2 グローバル制御ブロック構造の長形式をフォーマットします。 リソース・マネージャー固有のすべてのグローバル情報と、システム全体のグローバル制御ブロックが含まれます。 |
| ALL | すべての重要な Db2 制御ブロックをフォーマットします。トレース表、グローバル・ストレージ内の制御ブロック、およびサブシステムのすべてのアクティブ・アドレス・スペース内の制御ブロックが含まれます。
TT、AA、および LG を指定するのと同等です。 |
| SUMDUMP | ダンプ・フォーマッターに対する入力データとして使用するダンプ・データ・セット内の部分を指定します。
DSNWDPRD ダンプ・フォーマッターは、入力ダンプ・データがダンプ・データ・セットの要約部分から取得されたか要約部分以外から取得されたかに関係なく、常に同じ制御ブロックおよびデータ構造をフォーマットしようと試みます。 |
| DS | 報告するエージェントに関する詳細レベルを指定します。
|
| LM | 報告する IRLM に関する情報を指定します。
|
| SM | 報告するストレージ・マネージャーに関する情報を指定します。
|
| PHB | PHB アドレスを指定します。SM が指定された場合、ストレージ・マネージャー情報は、このアドレスを持つ PHB についてのみ表示されます。 |
| ST | スタック・ストレージに関する情報を指定します。
|
| SMSA | 要求された ASID およびグローバル・ストレージのみのストレージ情報を指定します。 |
| DM | 報告するデータ・マネージャー情報を指定します。
|
| BM | 報告するバッファー・マネージャー情報を指定します。
|
| SH | 報告するデータ共用情報を指定します。
|
| DB | 報告するデータベース記述子情報を指定します。
|
| CT | 特定のエージェントの CT アドレスを指定します。 このパラメーターを DM オプションまたは DB オプションと一緒に使用することで、出力を単一エージェントに絞り込むことができます。 |
| ET | 例外状態に関する情報を指定します。
|
| DI | 報告する DDF スレッドに関する情報を指定します。
|
| DISYS | 報告する DDF システムに関する情報を指定します。
|
| TOKEN | 表示する特定のスレッドの TOKEN 値を指定します。 このオプションは、DI オプションおよび DS=3 オプションまたは DS=4 オプションと一緒に使用します。TOKEN 値が無効である場合、あるいは指定された TOKEN に関連付けられたスレッドがない場合、警告メッセージが表示されます。 |
RS![]() |
報告するリレーショナル・データ・サービス情報を指定します。
![]() |
SP ![]() |
報告するストアード・プロシージャー情報を指定します。
![]() |
以下のキーワード・デフォルト値を使用します。
- SUBSYS キーワードを SUMDUMP=YES と一緒に指定した場合、SUBSYS キーワードは、ダンプ・データ・セットで要約レコードが見つからない場合にのみ使用されます。 この場合、SUBSYS キーワードは、ダンプ・データ・セットの非要約部分にある重要な Db2 制御ブロックを見つけるために使用されます。
- DSNWDMP 制御カードで以下のいずれのオペランドも指定されない場合のデフォルトは ALL です。
AA SA LG - 以下のオペランドの各セットで、すべてのオペランドが同じ制御ステートメントで使用された場合は、最初のオペランドが後続のオペランドをオーバーライドします。
このような動作になるのは、最初のオペランドが生成する定様式データに、後続のオペランドによって生成される定様式データが含まれるためです。
ALL TT ALL LG ALL AA SA例えば、ALL と LG の両方のオペランドを指定した場合、ALL が LG をオーバーライドします。
- DS オプションが指定されない場合、出力に定様式のエージェント情報は含まれません。
SUMDUMP 情報
フォーマットされた制御ブロックは「揮発性」データと「静的」データの両方から構成されるため、入力ダンプ・データは、エラー発生時に可能な限り近い時刻の制御ブロックの状態に基づいて選択する必要があります。
- SUMDUMP=YES
- SVC ダンプの場合、デフォルトでは、ダンプ・フォーマッターへの入力データとして要約データ・レコードが使用されます。これは、要約データ・レコードには、エラー発生時に近い時刻に収集された「揮発性」データが含まれているためです。 YES を指定することで、関連する Db2 診断情報が確実に送信されます。
- SUMDUMP=NO
- 非要約データはダンプの生成時に現行のシステム・アクティビティーとは非同期に取得されるため、「揮発性」データは、ダンプ・データ・セットに入るまでに変更されたり失われたりしている可能性があります。
ダンプ・データの収集時、あるいはダンプ・データ・セットの要約部分のフォーマット中にエラーが発生した場合に、このオプションを使用します。 そのような状況では、該当するエラー・メッセージが発行されます。 さらに、このオプションを使用して、スタンドアロン・ダンプあるいは動的 (z/OS® コンソール) ダンプをフォーマットします。
DS 情報
DS オプションを使用して、ハングおよび待機を診断することができます。 DS オプションは、ダンプ取得時の Db2 内のアクティビティーのスナップショットを提供します。
DS=1 オプションを指定した場合に生成された出力は、以下のようになります。
1 2 3 4
ACE: 0A85FD28 Status: T Req: 010B Allied Chain
5 6 7 8 9
Authid: FRNT Plan: FRNMFRNT Corrid: GT00FRNT Corrname: PLACQA09 Token: 000004C0
EB Primary(Asid) Home(Asid) EBSPAWND TCB/SRB -Status-- R14
0A85FD98 ISCICQ09(007D) ISCICQ09(007D) 00000000 007ABD90 Running 8BA6D1FA
Jobname #T2QMBB ASID(0032)
1 2 3 4
ACE: 0D5C7990 Status: T Req: 0005 Allied Chain
CT: 67290030 Sh/Lg: 67248840 140K Vlong: 67248BD0 56K
5 6 7 8 9
Authid: SOFPROD Plan: DSNREXX Corrid: #T2QMBB Corrname: DB2CALL Token: 0001389C
EB Primary(Asid) Home(Asid) EBSPAWND TCB/SRB -Status-- R14
10 11 12 13 14 15 16 17
0D5C7A20 #T2QMBB (0032) #T2QMBB (0032) 00000000 007BF788 Running 8F869734 01/20/2004 15:27:02.850291
| 図のラベル | 説明 |
|---|---|
| 1 | エージェントの ACE のアドレス。 |
| 2 | スレッドの状況。この値は、コマンド -DISPLAY THREAD の出力の ST フィールドおよび A フィールドと同じです。 |
| 3 | 要求カウント。この値は、コマンド -DISPLAY THREAD の出力の REQ フィールドと同じです。 |
| 4 | ACE が属しているチェーン。可能な値は、System Chain、Allied Chain、または Stored Proc です。 |
| 5 | サインオンされた接続に関連付けられた許可 ID。 サインオンが行われていない場合、この値はブランクです。 |
| 6 | エージェントのプラン名。この値は、コマンド -DISPLAY THREAD の出力の PLAN フィールドと同じです。 |
| 7 | エージェントの相関 ID。この値は、コマンド -DISPLAY THREAD の出力の ID フィールドと同じです。 |
| 8 | エージェントの相関名。 |
| 9 | スレッドに関連付けられたトークン。この値は、コマンド -DISPLAY THREAD の出力の TOKEN フィールドと同じです。 |
| 10 | 実行ブロックのアドレス。 |
| 11 | 1 次アドレス・スペースの ASID。 |
| 12 | ホーム・アドレス・スペースの ASID。 |
| 13 | 作成された実行ブロックのアドレス (存在する場合)。 |
| 14 | TCB アドレス (これが TCB である場合)。これが SRB である場合、この値はゼロです。 |
| 15 | 異常終了の発生時にエージェントが Db2 によって停止されたかどうか。 |
| 16 | 最後にその停止が要求されたときのレジスター 14 の値。 この値は、エージェントが停止された場合にのみ有効です。 |
| 17 | 停止が発生したタイム・スタンプ。 |
Db2 内の関連スレッドを表示するには、オプション DS=1 または DS=2 を指定して DSNWDMP を実行します。 オプション DS=2 は、すべての関連スレッドに関する情報を生成しますが、DS=1 は、アクティブ・スレッドについてのみ生成します。
以下の出力は、シャットダウン時に Db2 がハングした後に、オプション DS=2 を指定して DSNWDMP を実行したものです。 最初の ACE の詳細は、シャットダウン時に CICS® がアクティブであったことを示しています。これがハングの理由です。
ACE: 0A85FD28 Status: T Req: 010B Allied Chain
Authid: FRNT Plan: FRNMFRNT Corrid: GT00FRNT Corrname: PLACQA09 Token: 000004C0
EB Primary(Asid) Home(Asid) EBSPAWND TCB/SRB -Status-- R14
0A85FD98 ISCICQ09(007D) ISCICQ09(007D) 00000000 007ABD90 Running 8BA6D1FA
ACE: 0A040318 Status: N Req: 0003 Allied Chain
Authid: ISCICQ09 Plan: Corrid: Corrname: PLACQA09 Token: 00000000
EB Primary(Asid) Home(Asid) EBSPAWND TCB/SRB -Status-- R14
0A040388 ISCICQ09(007D) ISCICQ09(007D) 00000000 007A53C8 Running 00000000
DS=3 を指定した場合の出力には、関連エージェントとシステム・エージェントの両方が表示されます。 オプション DS=3 は、タスクが関連作業に関与しているが、システム ACE チェーン上にあるような場合に、CPU 並列処理や分散データ機能などの領域の問題を診断するのに役立ちます。
以下の出力は、並列タスクでハングが発生した後にオプション DS=3 を指定した DSNWDMP を示しています。
ACE: 04FA2D28 Status: PT* Req: 0000 System Chain
Authid: USRT001 Plan: MYPLAN Corrid: RUN01 Corrname: BATCH Token: 00000000
EB Primary(Asid) Home(Asid) EBSPAWND TCB/SRB -Status-- R14
04FA2D98 V42ADBM1(0067) V42ADBM1(0067) 80000000 00000000 Running 8BA6D1FA
ACE: 04FA2BB8 Status: PT* Req: 0000 System Chain
Authid: USRT001 Plan: MYPLAN Corrid: RUN01 Corrname: BATCH Token: 00000000
EB Primary(Asid) Home(Asid) EBSPAWND TCB/SRB -Status-- R14
04FA2C28 V42ADBM1(0067) V42ADBM1(0067) 80000000 00000000 Running 8BA6D1FA
ACE: 04FA2A48 Status: PT* Req: 0000 System Chain
Authid: USRT001 Plan: MYPLAN Corrid: RUN01 Corrname: BATCH Token: 00000000
EB Primary(Asid) Home(Asid) EBSPAWND TCB/SRB -Status-- R14
04FA2AB8 V42ADBM1(0067) V42ADBM1(0067) 80000000 00000000 Running 8BA6D1FA
LM 情報
ACE: 05419548 Status: T * Req: 0004 Allied Chain
Short: 7F298820
Authid: USRT001 Plan: TSTA85 Corrid: GT00XA85 Corrname: CICS41 Token: 00000003
EB Primary(Asid) Home(Asid) EBSPAWND TCB/SRB -Status-- R14
054195D8 VB1ADBM1(0067) CICS41F (001C) 00000000 005A9388 Suspended 85539590
IRLM statistics for ACE: 05419548
Suspend count - latch conflict: 0
Suspend count - other conflict: 0
Lock request count: 2
Unlock request count: 1
Query request count: 0
Change request count: 0
Other IRLM requests count: 0
P-Lock Lock requests: 0
P-Lock Change requests: 0
P-Lock Unlock requests: 0
Lock requests sent to XES : 0
Change requests sent to XES : 0
Unlock requests sent to XES : 0
Suspends due to IRLM Global contention : 0
Suspends due to XES Global contention : 0
Suspends due to false contention : 0
Requests denied due to retained lock : 0
Notify messages sent : 0
WU requested a LOCK at 03/21/1997 20:00:47.736272 for resource 0C0000020004001700000000 at state 3
with modify interest.
This is a local resource that is held on this subsystem.
This request is incompatible with a lock on this subsystem and the current states of this resource are:
The local resultant held state is 8
The local modify held state is 8
Resource 0C0000020001005F00000000 is held in state 02 and was granted at 03/21/1997 20:00:47.620534.
Resource 0C000004E3E2E3C1F8F54040 is held in state 04 and was granted at 03/21/1997 20:00:45.712241.
Work unit 0067009505419548 holds 00000002 resource locks.

RS