共通の VRA 記録ルーチン

3 つの共通 VRA 記録ルーチン (DSNWSDWA、DSNTFRCV、および DSN9SCN9) が存在します。DSNWSDWA は、関係するサブコンポーネントに関係なく、すべての Db2® 異常終了の重要情報を記録します。DSNTFRCV と DSN9SCN9 は、特定のサブコンポーネントのみの重要情報を記録します。

以下の表では、次の情報を示しています。
  • VRA データを識別する VRA キー名
  • VRA キーの 16 進値
  • VRA キーが識別するデータの長さ
  • VRA キーが識別する情報

DSNWSDWA 表は、SDWA の SDWACOMU フィールドに「DSN1」が記録されるか、「DSN2」が記録されるかも識別します。この情報は、回復機能委任が発生したかどうかを示し、SYS1.LOGREC 項目の解釈に役立ちます。

DSNWSDWA によって記録される VRA データは、DSNWSDWA の初回呼び出しで保管されたデータを表します。z/OS® リカバリー終了マネージャー (RTM) によって回復機能委任が行われたエラーのために、DSNWSDWA が再び呼び出される場合、DSNWSDWA は VRARC、VRACBA、VRARRK1、および VRARRK2 フィールドのみを保管します。RTM 回復機能委任時に変更されない残りのフィールドは、保管されません。

Db2 リカバリー処理中に、DSNWSDWA ルーチンは、エラーの時点の PSW アドレス (SDWAEC1)、およびモジュール入り口点リスト (MEPL) から障害 CSECT に関する情報を収集しようとします。この情報は、VRAIMO キーの下で VRA に記録されてから、以下のタスクに使用されます。

  • 障害のあるロード・モジュール、CSECT、および SVC ダンプに関連したダンプ・タイトルのオフセットを提供する。
  • 障害のある CSECT のサマリー・ストレージ項目を提供して、障害のある CSECT 全体が SVC ダンプに含まれていることを確実にする。
表 1. DSNWSDWA によって記録される VRA データ
VRAKEY キー名 VRAKEY 16 進値 VRALEN データ長 VRADAT データ内容およびフォーマット 記録場所
DSN1 DSN2 04F
VRARC 06 4 バイト 異常終了理由コード (最初の VRARC 出現) はい はい はい
4 バイト DSNWSDWA 戻りコード (2 番目の VRARC 出現)      
VRACBA 14 4 バイト EB アドレス はい はい  
VRARRK1 C9 4 バイト EB ラッチ階層マスク はい はい はい
VRARRK2 CA 4 バイト サブシステム名 (非共用 Db2) はい    
16 バイト Db2 データ共用グループ名 (8 文字) とメンバー名 (8 文字)      
VRAAID 3A 2 バイト DSCF のバイナリー ASID はい    
2 バイト ADMF のバイナリー ASID はい    
2 バイト DDF アドレス・スペースのバイナリー ASID (DDF がアクティブである場合) はい    
2 バイト ホーム・アドレス・スペースのバイナリー ASID はい    
VRARRK3 CB 8 バイト ホーム・アドレス・スペースの接続 ID はい    
VRARRK4 CC 12 バイト スレッド相関トークン はい    
VRARRK19 DB 8 バイト エラーのストア・クロック (STCK) 時間 はい    
VRARRK21 DD 36 バイト 形式の追加スレッド情報: はい はい はい
4 バイト EBICE14: 実行単位切り替えの R14 (呼び出し元)1      
4 バイト EBSUS14: 中断の R14 (呼び出し元)1      
4 バイト EBRES6: EB 開始再開の R6 (EB)      
4 バイト EBRES14: EB 開始再開の R14 (呼び出し元)1      
4 バイト EBCAN6: EB 開始キャンセルの R6 (EB)      
4 バイト EBCAN14: EB キャンセル要求の R14 (呼び出し元)1      
4 バイト EBOCAN14: オリジナル・キャンセル要求の R14 (呼び出し元)1      
4 バイト EBSPAWND: spawn された EB      
4 バイト EBSC14: キャンセルが受け入れられたときの中断の R14 (呼び出し元)      
VRARRK23 DF 2 バイト スレッド・タイプ:
  • 'S' Db2 システム・スレッド
  • 'A' 関連スレッド (分散アクティビティーなし)
  • 'D' データベース・アクセス・スレッド
  • 'R' リモート・アクティビティーとの関連スレッド
はい    
VRAIMO 7C 12 バイト 障害のある CSECT の情報 はい    
2 バイト X'FFFF'=CSECT データの取得      
  X'0000'=CSECT が MEPL にない      
2 バイト 障害命令オフセット      
4 バイト 障害のある CSECT の開始アドレス      
2 バイト CSECT の長さ      
2 バイト 障害のある CSECT の ASID      
VRADAE 53 0 バイト DAE の使用を示す はい    
VRAMINSC 52 2 バイト DAE 症状ストリング・カウント はい    
注:
  1. 特定の Db2 CSECT とオフセットに合わせて R14 アドレスを調整するには、ダンプまたは Diagnose Display MEPL ユーティリティーの出力が必要です。同じ Db2 インスタンスに対してダンプまたは Display MEPL 出力を取得する必要があります。
   
表 2. DSNLFRCV によって記録される VRA データ. Db2 分散データベース機能がこのルーチンを使用します。
VRAKEY キー名 VRAKEY 16 進値 VRALEN データ長 VRADAT データ内容およびフォーマット
VRARRK20 DC 2 バイト DDF の内部障害 ID
VRARRK24 E0 16 バイト このトランザクションの要求側ロケーションのロケーション名 (このロケーションが要求側ロケーションである場合はゼロ)
VRARRK25 E1 24 バイト エージェントの作業論理単位 ID (LUWID)
VRARRK26 E2 34 バイト 分散リクエスター情報:
8 バイト リクエスター製品 ID pppvvrrm。ここで、
製品 ID の形式は pppvvrrm です。ここで、ppp は 3 文字で構成される製品コード (Db2 の場合は DSN など)、vv はバージョン、rr はリリース、m はモディフィケーション・レベルです。例えば、DSN11015は、新規機能モードでのDb2 11を表し、その値は「DSN11015」です。製品コード (ppp) は、以下のいずれかの値です。
  • IBM Db2 Analytics Accelerator for z/OSの場合は AQT
  • DB2® Server for VSE & VMの場合は ARI
  • Db2 for z/OSの場合は DSN
  • IBM® Data Server Driver for JDBC and SQLJの場合は JCC
  • DB2 for iの場合は QSQ
  • Db2 for Linux, UNIX, and Windowsの場合は SQL
モディフィケーション (m) 値の意味は、次のとおりです。変更の始まり
0
DB2 10 からのマイグレーションのための変換モードおよび新機能有効モード (CM10、CM10*、ENFM10、および ENFM10*)
5
新機能モード。
変更の終わり
8 バイト リクエスター LU 名または IP アドレスの内部形式
16 バイト リクエスター・ロケーション名
2 バイト 予約済み
VRARRK27 E3 17 バイト 異常終了リカバリー再試行ルーチン ID 情報:
4 バイト 再試行ルーチンのアドレス
4 バイト 再試行ルーチンのコンポーネント ID
1 バイト 未使用、常にブランク
8 バイト 再試行ルーチンの機能 ID
表 3. DSNTFRCV によって記録される VRA データ. Db2 データベース・サービス・サブコンポーネントと分散データ機能がこのルーチンを使用します。
VRAKEY キー名 VRAKEY 16 進値 VRALEN データ長 VRADAT データ内容およびフォーマット
VRARRK5 CD 5 バイト エラーを検出したデータ・マネージャー (DM) サブコンポーネント CSECT (CTERPROC) の名前
VRARRK6 CE 2 バイト データ・マネージャー (DM) サブコンポーネントの内部修飾子 (CTERQUAL)
VRARRK7 CF 4 バイト データ・マネージャー (DM) サブコンポーネントの戻りコード (CTDMRETC)
VRARRK8 D0 4 バイト データ・マネージャー (DM) サブコンポーネントからの理由コード (CTSIRCOD)
VRARRK9 D1 4 バイト データ・マネージャー (DM) サブコンポーネントが最後に呼び出した機能からの戻りコード (CTRMRC)
VRARRK10 D2 4 バイト リレーショナル・データ・システム (RDS) サブコンポーネントからの SQL コード (SQLCODE)
VRARRK11 D3 8 バイト リレーショナル・データ・システム (RDS) サブコンポーネントからの SQL エラー・プロシージャー名 (SQLERRP)
VRARRK12 D4 4 バイト リレーショナル・データ・システム (RDS) サブコンポーネントの SQL エラー・プロシージャーによって戻される内部コード (SQLERRD1)
VRARRK13 D5 変数 「リソース使用不可」の理由コード (CTRURESN)。 理由コードが使用可能である場合、長さは 4 バイトです。そうでない場合、長さは 0 です。
VRARRK14 D6 変数 「リソース使用不可」のリソース・タイプ (CTRUTYPE)。 理由コードが使用可能である場合、長さは 4 バイトです。そうでない場合、長さは 0 です。
VRARRK15 D7 変数 「リソース使用不可」のリソース名 (CTRUNAME)。 リソース名が使用可能である場合、長さは 1 - 44 バイトです。そうでない場合、長さは 0 です。
VRARRK16 D8 4 バイト リソース・マネージャー (RM) からの理由コード (CTUNERMR)
VRARRK20 DC 2 バイト DDF の内部障害 ID
VRARRK27 E3 17 バイト 異常終了リカバリー再試行ルーチン ID 情報:
4 バイト 再試行ルーチンのアドレス
4 バイト 再試行ルーチンのコンポーネント ID
1 バイト 未使用、常にブランク
8 バイト 再試行ルーチンの機能 ID
VRARRK33 E9 12 バイト P ロック・ネゴシエーション情報:
  • 1 バイト: P ロック保持状態
  • 1 バイト: P ロック・キャッシュ状態
  • 1 バイト: P ロック要求状態
  • 1 バイト: 未使用
  • 8 バイト: P ロック所有作業単位
表 4. DSN9SCN9 によって記録される VRA データ. Db2 システム・サービス・サブコンポーネントがこのルーチンを使用します。これらのサブコンポーネントには、メッセージ生成プログラム、リカバリー・ログ・マネージャー、汎用コマンド・プロセッサー、および場合によっては計測機能が含まれます。
VRAKEY キー名 VRAKEY 16 進値 VRALEN データ長 VRADAT データ内容およびフォーマット
VRACBM 11 8 バイト DDT の DSECT (DSNDDDT) の名前
VRACB 12 変数 リカバリー・ルーチンを起動したモジュールの名前などの情報を含む、診断データ表 (DDT) 制御ブロックの記録可能部分。
VRARC 06 4 バイト 異常終了理由コード
表 5. DSNWDSDM によって記録される VRA データ
VRAKEY キー名 VRAKEY 16 進値 VRALEN データ長 VRADAT データ内容およびフォーマット
VRARRK5 CD 5 バイト エラーを検出したデータ・マネージャー (DM) サブコンポーネント CSECT (CTERPROC) の名前
VRARRK6 CE 2 バイト データ・マネージャー (DM) サブコンポーネントの内部修飾子 (CTERQUAL)
VRARRK11 D3 8 バイト リレーショナル・データ・システム (RDS) サブコンポーネントからの SQL エラー・プロシージャー名 (SQLERRP)
VRARRK12 D4 4 バイト 内部コード
VRARRK20 DC 24 バイト DDF の内部障害 ID
VRARRK22 DE 6 バイト ダンプ作業域が取得されませんでした。(NODMPW)
VRAIMO 7C 12 バイト 障害のある CSECT の情報
2 バイト X'FFFF'=CSECT データの取得
  X'0000'=CSECT が MEPL にない
2 バイト 障害命令オフセット
4 バイト 障害のある CSECT の開始アドレス
2 バイト CSECT の長さ
2 バイト 障害のある CSECT の ASID