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-options:
構文図を読む
>>-+---------------------------------------------+-------------><
   '-+-DS=1-+-+------------+-+-----------------+-'   
     +-DS=2-+ '-,-+-LM=1-+-' '-,TOKEN=xxxxxxxx-'     
     +-DS=3-+     +-LM=2-+                           
     '-DS=4-'     '-LM=3-'                           

sm-options:
構文図を読む
>>-+-------------------------------------------+---------------><
   '-+-SM=1-+-+------------+-+---------------+-'   
     +-SM=2-+ '-,SMSA=asid-' '-,PHB=phb-addr-'     
     +-SM=3-+                                      
     +-SM=4-+                                      
     +-SM=5-+                                      
     '-SM=6-'                                      

st-options:
構文図を読む
>>-+------+----------------------------------------------------><
   +-ST=1-+   
   +-ST=2-+   
   '-ST=3-'   

dm-options:
構文図を読む
>>-+---------------------------+-------------------------------><
   '-+-DM=1-+-+--------------+-'   
     '-DM=2-' '-,CT=xxxxxxxx-'     

bm-options:
構文図を読む
>>-+-------------------------------------------------------+---><
   '-+-BM=1----------------------------------------------+-'   
     +-BM=2----------------------------------------------+     
     '-BM=3-+------------+-+---------------------------+-'     
            '-,BBIP=vvvv-' '-,DBID=yyyy-+------------+-'       
                                        '-,OBID=zzzz-'         

sh-options:
構文図を読む
>>-+----------+------------------------------------------------><
   '-+-SH=1-+-'   
     +-SH=2-+     
     +-SH=3-+     
     +-SH=4-+     
     '-SH=5-'     

db-options:
構文図を読む
>>-+-------------------------------------------------+---------><
   '-+-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-'                      

et-options:
構文図を読む
>>-+----------+------------------------------------------------><
   '-+-ET=1-+-'   
     '-ET=2-'     

di-options:
構文図を読む
>>-+--------------------------+--------------------------------><
   '-+-DI=1-+-,TOKEN=xxxxxxxx-'   
     '-DI=2-'                     

disys-options:
構文図を読む
>>-+-------------+---------------------------------------------><
   '---DISYS=1---'   

rs-options:
構文図を読む
>>-+----------+------------------------------------------------><
   '-+-RS=1-+-'   
     '-RS=2-'     

sp-options:
構文図を読む
>>-+----------+------------------------------------------------><
   '-+-SP=1-+-'   
     +-SP=2-+     
     '-SP=3-'     

複数のオペランドは、ブランクではなくコンマで区切ります。制御ステートメントでは、オペランドの後ろにブランクがあると、そこでオペランド・リストが終わると見なされ、後続のオペランドは無視されます。 以下の表は、ダンプをフォーマットするために Db2 制御ステートメントで指定することができるさまざまなキーワードをリストおよび説明しています。

表 1. Db2 によって発行された SVC ダンプをフォーマットするためのキーワード
キーワード 説明
SUBSYS= nnnn サイト定義の Db2 サブシステム名 (nnnn) を指定します。 範囲は、1 文字から 4 文字です。

SUMDUMP=YES の場合はオプション、SUMDUMP=NO の場合は必須です。

詳しくは、SUMDUMP 情報 を参照してください。

TT Db2 グローバル・トレース表をフォーマットします。
  • サブオプションなしで TT が指定された場合、グローバル・トレース表をフォーマットします。
  • TT=1 の場合、要約行を表示します。
  • TT=2 の場合、TT=1 の情報とデータ項目を表示します。
  • TT=3 かつ DS も指定された場合、EB によって情報をフィルタリングします。
AA サブシステムのすべてのアクティブ・アドレス・スペース内の重要な Db2 制御ブロックをフォーマットします。
SA 単一アドレス・スペースに関連付けられた重要な Db2 制御ブロックをフォーマットします。 制御ステートメントは、ASID を 16 進 (最大 4 桁) で指定する必要があります。 アポストロフィおよび先行ゼロは、含めることも省略することもできます (例えば、DE、00DE、または '00DE' のようになります)。
LG 重要な Db2 グローバル制御ブロック構造の長形式をフォーマットします。 リソース・マネージャー固有のすべてのグローバル情報と、システム全体のグローバル制御ブロックが含まれます。
ALL すべての重要な Db2 制御ブロックをフォーマットします。トレース表、グローバル・ストレージ内の制御ブロック、およびサブシステムのすべてのアクティブ・アドレス・スペース内の制御ブロックが含まれます。

TT、AA、および LG を指定するのと同等です。

SUMDUMP ダンプ・フォーマッターに対する入力データとして使用するダンプ・データ・セット内の部分を指定します。
  • SUMDUMP=YES の場合、入力ダンプ・データは、ダンプ・データ・セットの要約部分から取得されます。
  • SUMDUMP=NO の場合、入力ダンプ・データは、ダンプ・データ・セットの要約部分以外から取得されます。

DSNWDPRD ダンプ・フォーマッターは、入力ダンプ・データがダンプ・データ・セットの要約部分から取得されたか要約部分以外から取得されたかに関係なく、常に同じ制御ブロックおよびデータ構造をフォーマットしようと試みます。

DS 報告するエージェントに関する詳細レベルを指定します。
  • DS=1 の場合、関連エージェント・チェーン上のスレッド・レベルにあるエージェントのみに関する表示情報が報告されます。
  • DS=2 の場合、関連エージェント・チェーン上のすべてのエージェントに関する表示情報が報告されます。
  • DS=3 の場合、システム・エージェント・チェーンと、関連チェーン上のすべてのエージェントに関する表示情報が報告されます。 並列タスクおよび DDF タスクの詳細を取得するには、システム・エージェント・チェーンが必要です。
  • DS=4 の場合、DS=3 の場合の情報に加えて、LUWID (作業論理単位 ID)、XID (グローバル・トランザクション ID)、ユーザー情報およびアカウンティング情報がエージェントごとに表示されます。
LM 報告する IRLM に関する情報を指定します。
  • LM=1 の場合、TRWA 統計を報告します。
  • LM=2 の場合、エージェントが IRLM 要求を待機している場合は、最後の要求の状況を報告します。
  • LM=3 の場合、すべてのエージェントについて、保持されているロックをリストします。
SM 報告するストレージ・マネージャーに関する情報を指定します。
  • SM=1 の場合、GPVT からの PHB チェーンを表示します。この情報により、グローバル・ストレージの使用量を知ることができます。
  • SM=2 の場合、SM=1 の場合の情報に加えて、各 PHB からの SHB チェーンを表示します。
  • SM=3 の場合、Db2 に接続されているすべてのアドレス・スペースについて、SM=2 の場合の情報を表示します。
  • SM=4 の場合、SM=3 の場合の情報に加えて、変数プールの割り振り済みストレージとフリー・ストレージの量に関する統計を表示します。
  • SM=5 の場合、SM=4 の場合の情報に加えて、割り振り済みエレメントの例を表示し、ストレージに対して GETMAIN を実行したモジュールを判別します。
  • SM=6 の場合、SM=5 の場合の情報に加えて、フリー・エレメントを表示します。
PHB PHB アドレスを指定します。SM が指定された場合、ストレージ・マネージャー情報は、このアドレスを持つ PHB についてのみ表示されます。
ST スタック・ストレージに関する情報を指定します。
  • ST=1 の場合、異常終了したタスクに関する PSW、SDWA のレジスター、および保存域トレースを表示します (コンソール・ダンプを除く)。 DS オプションも指定された場合、上位 SKB とスタック・ストレージの使用量も表示されます。
  • ST=2 の場合、ST=1 の場合の情報に加えて、各スタックの定様式保存域トレースを表示します。 DS オプションも指定する必要があります。
  • ST=3 で、DS オプションも指定された場合、ST=2 の場合の情報に加えて、スタック・ストレージの定様式表示情報も表示されます。
SMSA 要求された ASID およびグローバル・ストレージのみのストレージ情報を指定します。
DM 報告するデータ・マネージャー情報を指定します。
  • DM=1 の場合、エージェント DMTR および LKTR のトレースをフォーマットします。
  • DM=2 の場合、DM=1 の場合の情報に加えて、エージェントの親ロック情報と、クレーム情報およびドレーン情報を表示します。
BM 報告するバッファー・マネージャー情報を指定します。
  • BM=1 の場合、エージェント BBTR のトレースをフォーマットします。
  • BM=2 の場合、BM=1 の場合の情報に加えて、エージェント BBRA の情報を表示します。
  • BM=3 の場合、すべての PB および PB0 をフォーマットします。報告される情報量を制限するために、バッファー・プール、DBID、または OBID でフィルタリングすることができます。
SH 報告するデータ共用情報を指定します。
  • SH=1 の場合、エージェント BBTR のトレースをフォーマットします。
  • SH=2 の場合、SH=1 の場合の情報に加えて、エージェント BBRA の情報を表示します。
  • SH=3 の場合、SH=2 の場合の情報に加えて、エージェント BBRA の情報を表示します。
  • SH=4 の場合、SH=3 の場合の情報に加えて、エージェント BBRA の情報を表示します。
  • SH=5 の場合、SH=4 の場合の情報に加えて、エージェント BBRA の情報を表示します。
DB 報告するデータベース記述子情報を指定します。
  • DB=1 の場合、メモリー内にある DBD をリストします。DBID も指定された場合、その DBID に関する情報のみがリストされます。
  • DB=2 の場合、DB=1 の場合の情報に加えて、DBD セクション情報を表示します。
  • DB=3 の場合、DB=2 の場合の情報に加えて、OBD 情報を表示します。
  • DB=4 の場合、指定された DBID および OBID の情報をフォーマットします。DBID パラメーターおよび OBID パラメーターが必須です。
  • DB=5 の場合、DB=4 の場合の情報に加えて、トリガー情報および参照制約情報を表示します。 DBID パラメーターおよび OBID パラメーターが必須です。
CT 特定のエージェントの CT アドレスを指定します。 このパラメーターを DM オプションまたは DB オプションと一緒に使用することで、出力を単一エージェントに絞り込むことができます。
ET 例外状態に関する情報を指定します。
  • ET=1 の場合、例外状態をリストします。
  • ET=2 の場合、ET=1 の場合の情報に加えて、LPL、GRECP、および WEPR の情報をリストします。
DI 報告する DDF スレッドに関する情報を指定します。
  • DI=1 の場合、スレッドの DDF DTM (分散トランザクション・マネージャー) 関連情報。
  • DI=2 の場合、DI=1 の場合の情報に加えて、スレッドの DDF DC (データ通信) 関連情報。
DISYS 報告する DDF システムに関する情報を指定します。
  • DISYS=1 の場合、一般の DDF システム関連情報。
TOKEN 表示する特定のスレッドの TOKEN 値を指定します。 このオプションは、DI オプションおよび DS=3 オプションまたは DS=4 オプションと一緒に使用します。TOKEN 値が無効である場合、あるいは指定された TOKEN に関連付けられたスレッドがない場合、警告メッセージが表示されます。
変更の始まりRS変更の終わり 変更の始まり報告するリレーショナル・データ・サービス情報を指定します。
  • RS=1 の場合、SQL ステートメントおよび上位リレーショナル・データ・サービス情報を表示します。
  • RS=2 の場合、RS=1 の場合の情報に加えて、プラン情報およびパッケージ情報や SQLCA 情報など、より詳細な情報を表示します。
変更の終わり
変更の始まりSP 変更の終わり 変更の始まり報告するストアード・プロシージャー情報を指定します。
  • SP=1 の場合、ストアード・プロシージャーのヘッダー情報を表示します。
  • SP=2 の場合、WLM ストアード・プロシージャーに関するランタイム情報を表示します。
  • SP=3 の場合、ストアード・プロシージャーに関する詳細情報 (トレース情報など) を表示します。
変更の終わり

以下のキーワード・デフォルト値を使用します。

  • 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. DS=1 オプションを使用した DSNWDMP の出力例
         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® がアクティブであったことを示しています。これがハングの理由です。

図 2. シャットダウン時に Db2 がハングした後に DS=2 オプションを指定した DSNWDMP の出力
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 を示しています。

図 3. 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 情報

LM オプションを使用して、ロックの問題を診断します。 以下の出力は、エージェントについて保持されているロックに関する情報をスレッド・レベルで表示するために、オプション DS=1 または LM=3 を指定して DSNWDMP を実行することで取得されました。
図 4. 保持されているロック情報について DS=1 および LM=3 を指定した DSNWDMP の出力
  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.