IFCID 0191 レコードの解釈
各 IFCID 0191 トレース・レコードには、DDIS による構文解析が成功または失敗した各 DDM レベル 6b オブジェクトについて、1 つの QW0191HD セクション、1 つの QW0191CR セクション、および 1 つの QW01916B セクションが含まれます。

処理される DDM オブジェクトによっては、QW0191CR セクション、QW0191FD セクション、QW0191RT セクション、および QW0191LT セクションが関連付けられている場合があります。
- DDM オブジェクトが QRYDSC、あるいは SQLDTA オブジェクトまたは SQLDTARD オブジェクト内に含まれている FDODSC スカラーのいずれかである場合に、QW0191FD セクションが存在します。
- DDM オブジェクトが QRYDTA、あるいは SQLDTA オブジェクトまたは SQLDTARD オブジェクト内に含まれている FDODTA スカラーのいずれかである場合に、QW0191RT セクションが存在します。
- DDM オブジェクトが FDOCA Early または Late Descriptor によって記述されたコマンド・データ・オブジェクトまたは応答データ・オブジェクトのいずれかである場合に、QW0191LT セクションが存在します。
QW0191HD セクションの読み方
QW0191HD セクションには、以下のフィールドが含まれます。
- QW0191RS
- DDIS 理由コードが含まれます。これは、DRDA 例外条件を一意的に記述します。DRDA 例外条件をさらに診断する場合は、この理由コードをベースとして使用してください。
- QW0191MN
- 0191 レコードを要求した DDF モジュール (DRDS、DDIS、DTM) の名前が含まれます。
- QW0191NO
- QW019190 で指定されている総数に対する、この IFCID 0191 レコード・インスタンスの数が含まれます。
- QW0191T0
- すべての DDM オブジェクトおよび FDOCA データを収集するために必要な IFCID 0191 レコードの総数が含まれます。
- QW0191FL
- データ・ストリームから取得され、DRDA 例外条件を引き起こした DDM オブジェクトまたは FDOCA データの長さが含まれます。
- QW0191MI
- 固有の 2 バイトの ID。これは、0191 要求が行われた時点で QW0191MN に定義されていたモジュール内の処理ポイントを識別します。
- QW0191TK
- 固有の 12 文字のエラー・トークン。
- QW0191C1
- 処理が 0191 レコードに関する要求を引き起こした DDM コマンドのコード・ポイント。
- QW0191PA
- コマンドの DDIS 構文解析状態。
- これが 'P1' である場合、0191 レコードの残りのセクションは、AR から受け取った応答メッセージおよび応答データ・オブジェクトを表します。
- これが 'P2' である場合、0191 レコードの残りのセクションは、AR から受け取ったコマンド・データ・オブジェクトを表します。
- QW0191LN
- AR のロケーション名 (QW0191PA が 'P2' である場合)、または AS のロケーション名 (QW0191PA が 'P1' である場合)。
- QW0191RN
- コマンドに対する応答で AS から返された応答メッセージの総数。 QW0191PA が 'P2' である場合、これは 0 です。
- QW0191ON
- AR から受け取った OBJDSS の総数。
- QW0191DN
- 受け取ったレベル 6b データ・ストリームの総数。これらのデータ・ストリームは、すべて同じ要求関連子を持ちます。
- QW0191ET
- 検出されたエラーに対する Db2® 応答を定義します。
- QW0191ET が 0 である場合、Db2 がデータ・ストリームで構文エラーおよび意味エラーを検出しなかったことを意味します。
- QW0191ET が 1 である場合、SQLCODE および SQLSTATE による SQLCA のフォーマットが行われる原因となったエラーまたは例外条件を Db2 AR が検出したことを意味します。 この場合、QW0191SS には SQLSTATE が含まれます。
- QW0191ET が 2 である場合、AR に送信されている DDM 応答メッセージの原因となったエラーまたは例外条件を Db2 が検出したことを意味します。 DDM 応答メッセージのコード・ポイントが QW0191C2 に含まれます。
- QW0191PT
- QW0191PA が 'P1' である場合、QW0191PT には、最上位 DDIS 応答パーサー (DSNLZRPA) の最後の 5 つの状態およびイベントが含まれます。 同様に、QW0191PA が 'P2' である場合、QW0191PT には、最上位 DDIS 要求パーサー (DSNLZSPA) の最後の 5 つの状態およびイベントが含まれます。 これらのパーサーは、有限状態マシンとして実装されています。その結果、(state,event) トレースは、パーサーを介して最後のパスを提供します。
QW0191CR セクションの読み方
QW0191PA の値が 'P1' である場合、コマンドに対する応答で処理されたすべての応答メッセージおよび応答データ・オブジェクトについて、それぞれ 1 つの QW0191CR セクションが含まれます。 QW0191PA の値が 'P2' である場合、処理されたコマンドに対して 1 つの QW0191CR が含まれます。また、処理されたすべてのコマンド・データ・オブジェクトについて、それぞれ 1 つのセクションが含まれます。
QW0191CR セクションには、以下のフィールドが含まれます。
- QW0191PS
- DDM オブジェクトの構文解析状態が含まれます。値が 'DRDUCC' である場合、このオブジェクトの構文解析は正常に完了しました。 値が 'DRDAFAIL' である場合、オブジェクトの構文解析に失敗しました。
- QW0191C3
- コマンド、コマンド・データ・オブジェクト、応答メッセージ、または応答データ・オブジェクトのコード・ポイントが含まれます。
- QW0191NM
- QW0191C3 によって定義されたレベル 6b オブジェクトを運ぶ DSS 番号が含まれます。
- QW0191OF
- QW01916B セクションの 0191 レコードの開始点に対するオフセットが含まれます。これには、レベル 6b の RQSDSS、OBJDSS、または RPYDSS (QW0191C3 によって定義されたオブジェクトを含む) が含まれます。
QW0191PS が 'DRDUCC' である場合、QW0191FO の値は 0 です。QW0191PS が 'DRDAFAIL' である場合、QW0191FO のコンテンツは、構文解析が失敗した場所の 0191 レコードに対するオフセットです。 このオフセットは、QW01916B から始まるデータ・ストリーム内を指します。構文解析が失敗する原因は、QW0191C3 によって定義されたオブジェクトによって異なります。
QW0191C3 の値が X'241A' (QRYDSC) または X'2413' (SQLDTARD) である場合、オブジェクトには Late Descriptor が含まれます。 この場合、QW0191D1 には、Late Descriptor の構文解析の進行状況を記述している QW0191FD セクションの 0191 レコードの開始点に対するオフセットが含まれます。
QW0191C3 の値が X'241B' (QRYDTA) または X'2413' (SQLDTARD) である場合、オブジェクトには、Late Descriptor によって記述されたデータが含まれます。 この場合、QW0191D2 には、QW0191RT セクションの 0191 レコードの開始点に対するオフセットが含まれます。 このセクションには、Db2 RDTA データ構造が含まれます。これは、Late Descriptor から抽出された DRDA タイプと SQL タイプを相互に関連付けます。
QW0191C3 の値が X'243E' (SQLOBKNAM)、X'2414' (SQLSTT)、X'2419' (SQLSTTVRB)、X'2408' (SQLCARD)、X'2411' (SQLDARD)、X'241B' (QRYDTA)、または X'2413' (SQLDTARD) である場合、オブジェクトには、Early または Late FD:OCA Descriptor によって記述されたデータが含まれます。この場合、QW0191D3 には、QW0191LT セクションの 0191 レコードの開始点に対するオフセットが含まれます。 このセクションには、Db2 データ構造 (FDLIDLST) が含まれます。これは、Early または Late Descriptor を表し、データ・ストリームからのデータの取得に使用されます。
QW0191C3 の値が X'2412' (SQLDTA) である場合、オブジェクトには、Early または Late FD:OCA Descriptor によって記述されたデータが含まれます。 この場合、QW0191D4 には、QW0191EA セクションの 0191 レコードの開始点に対するオフセットが含まれます。 このセクションには、Db2 の保守容易性を確保する目的のみで提供されている内部 Db2 構造が含まれます。
QW0191FD セクションの読み方
このセクションは、オブジェクトが Late Descriptor (SQLDTA または SQLDTARD) である場合にのみ、0191 レコード内に存在します。このセクションは、QW0191CR セクション内のオフセット QW0191D1 から見つけることができます。
- QW0191LD
- Late Descriptor の一部として送信された Late Environmental Descriptor の数が含まれます。
- QW0191L1
- 記述子から抽出された SQLDTAGRP LID が含まれます。これが 0 である場合、SQLDTAGRP は処理されませんでした。
- QW0191L2
- SQLDTARD 記述子から抽出された SQLCADTA LID が含まれます。QW0191PA が 'P2' である場合、これは 0 です。 QW0191PA が 'P1' であり、SQLCADTA 配列記述子が処理されていない場合も 0 です。
- QW0191L3
- SQLDTA 記述子から抽出された SQLDTA LID が含まれます。QW0191PA が 'P1' である場合、これは 0 です。QW0191PA が 'P2' であり、SQLDTA 配列記述子が処理されていない場合も 0 です。
- QW0191L4
- SQLDTARD 記述子から抽出された SQLDTARD LID が含まれます。QW0191PA が 'P2' である場合、これは 0 です。 QW0191PA が 'P1' であり、SQLDTARD 配列記述子が処理されていない場合も 0 です。
- QW0191GN
- トリプレット (Continue Previous トリプレットを除く) の総数が含まれます。これらのトリプレットは、LID によって DRDA タイプを参照し、SQLDTAGRP に含まれています。これは、渡されている入力ホスト変数の数 (QW0191PA が 'P2' の場合)、または応答セット内の列数 (QW0191PA が 'P1' の場合) です。
- QW0191F0
- SQLDTAGRP 記述子の構造が正しい場合はオンです。構成要素 SQLDTAGRP トリプレットによって指定されたすべての LID が、有効な DRDA タイプを定義している必要があります。 SQLTAGRP が X'02' から X'49' の範囲外の LID を Late Environmental Descriptor として指定した場合、SQLTAGRP メタデータ定義 (MDD) (DRDA タイプ X'D0') が SQLTAGRP GDA の前にあり、各 Late Environmental Descriptor がその 7 バイトの MDD および 12 バイトの SDA によって指定されている必要があります。
- QW0191F1
- SQLCADTA 行記述子の構造が正しい場合はオンです。SQLCADTA 行は、すべての SQLCAGRP のオカレンスとその後に続く SQLDTAGRP のすべてのエレメントを定義する必要があります。
QW0191PA が 'P1' である場合、DDM オブジェクトは、QRYDSC または SQLDTARD の FDODSC スカラーのいずれかです。
QW0191PA が 'P2' である場合、DDM オブジェクトは、SQLDTA オブジェクトの FDODSC スカラーです。
SQLTAGRP が Late Environmental Descriptor を指定した場合、SQLCADTA RLO の前にタイプ X'E0' のメタデータ定義 (MDD) がなければなりません。
SQLDTAGRP 要件を満たすことに加えて、SQLCADTA 行記述子は、(NULL 可能) SQLCAGRP のすべてのエレメントとその後に続く SQLDTAGRP のエレメントのすべてのオカレンスから構成される行を定義する必要があります。 SQLCAGRP および SQLDTAGRP に対する参照は、LID によって行います。SQLCAGRP に対する参照は X'54' でなければならず、SQLDTAGRP に対する参照は SQLDTAGRP 記述子で示される LID と同じでなければなりません。
- QW0191F2
- SQLDTA 記述子の構造が正しい場合はオンです。SQLDTA 記述子では、すべての Late Environmental Descriptor が SQLTAGRP 記述子の前になければなりません。
SQLDTA/SQLDTARD 構造では、すべての Late Environmental Descriptor が SQLDTAGRP 記述子の前になければなりません。
また、構成要素 SQLDTAGRP トリプレットに含まれているすべての LID が、一部の Late Environmental Descriptor によって以前に定義されている必要があります。定義されていない場合は、デフォルトで DRDA タイプになります。
後者の場合、LID は X'02' から X'4F' の範囲および X 'C8' から X'CF' の範囲でなければなりません。これらの要件のいずれかが満たされていない場合、SQLDTA/SQLDTARD 構造は誤っています。
SQLDTAGRP 要件を満たすことに加えて、SQLDTA 記述子は、SQLDTAGRP のすべてのオカレンスとして行を定義する必要があります。 SQLDTAGRP に対する参照は LID を介して行われ、この参照は、SQLDTAGRP 記述子によって指定された LID と同じでなければなりません。 SQLTAGRP が Late Environmental Descriptor を指定した場合、SQLDTA RLO の前にタイプ X'E4' のメタデータ定義 (MDD) がなければなりません。 これらの要件が満たされていない場合、SQLDTA 構造は誤っています。
- QW0191F3
- SQLDTARD 行の構造が正しい場合はオンです。SQLCADTA 行に従って、記述子は、各行が SQLCADTA 行の 1 つのオカレンスであるような (オープン) 配列として SQLDTARD 配列を定義する必要があります。 SQLCADTA 行に対する参照は LID によって行われるため、SQLDTARD 配列内で参照される LID は、SQLCADTA 行記述子で示される LID と同じでなければなりません。 SQLTAGRP が Late Environmental Descriptor を指定した場合、SQLDTA RLO の前にタイプ X'E4' のメタデータ定義 (MDD) がなければなりません。 これらの要件のいずれかが満たされていない場合、SQLDTARD 構造は誤っています。
QW0191RT セクションの読み方
QW0191RT セクションは、オブジェクトに Late Descriptor が含まれている場合にのみ含まれます。したがって、このセクションは、オブジェクトが QRYDSC、SQLDTA、SQLDTARD、または OUTOVR である場合にのみ含まれます。 QRYDSC および SQLDTARD には、いずれも Late SQLDTARD Descriptor が含まれ、Db2 出力 SQLDA にマップしています。SQLDTA オブジェクトの FDODSC スカラーには、Late SQLDTA Descriptor が含まれており、Db2 入力 SQLDA にマップしています。
OUTOVR 記述子には、出力 SQLDA のオーバーライド・タイプ情報が含まれており、LOB データ・フォーマットがオーバーライドされている場合にのみ適用されます (LOB データ値から LOB ロケーター、またはその逆)。
このセクションには、SQLDTAGRP から作成された Db2 RDTA データ構造が含まれます。 SQLDTAGRP のエレメントの 1 つとして処理された LID ごとに 1 つの RDTAENT 項目があります。 RDTANUM の値は、SQLDTAGRP に含まれている SDA 参照の数と同じです。
この構造内の各 RDTAENT 項目について、Db2 由来の SQL タイプ、サブタイプ、CCSID、および長さが記録されています。 RDTA は、入力または出力 Db2 SQLDA のソースです。SQLDTAGRP トリプレットで指定された DRDA タイプを使用して、その DRDA タイプの 12 バイト SDA を検索します。SDA が文字としてデータを記述している場合、SBCS の場合のサブタイプは 1、混合の場合のサブタイプは 2、グラフィックの場合のサブタイプは 3 です。 サブタイプが文字データの場合、CCSID は、記述子の処理が行われたときに有効であった CCSID オーバーライドに由来します。
- Late Environmental Descriptor がこの LID を記述している場合、12 バイト SDA から CCSID を選択します。
- Late Environmental Descriptor がない場合、TYPDEFOVR コマンド/応答データ・オブジェクトによって指定されたコマンド・ローカル CCSID を選択します。
- Late Environmental Descriptor も TYPDEFOVR もない場合は、ACCRDB/ACCRDBRM の際に指定された CCSID を選択します。
RDTDA には、DRDS 用に作成された Db2 入出力 SQLDA のアドレスが含まれます。 SQLDA はトレースされません。RDTALID には、QW0191LT セクションに対するオフセットが含まれます。 これは、QW0191D3 が指すセクションと同じセクションを指します。 RDTAROW のコンテンツは 0 です。RDTAGLID は、SQLDTA 記述子および SQLDTARD 記述子から抽出された SQLDTAGRP LID で、RDTARLID は、SQLDTARD 記述子から抽出された SQLCADTA 行 LID です。 これらの値は、QW0191FD セクションに示される QW0191DG および QW0191CA の値と同じです。
データの取得中に DRDA 例外条件が発生した場合、RDTA は、RDS リソース・マネージャー (入力 SQLDA) または DRDS リソース・マネージャー (出力 SQLDA) に対して提示された SQLDA を指定します。
QW0191LT セクションの読み方
このセクションには、Early または Late Descriptor によって記述されたデータを取得するために使用する、Db2 FDLIDLST データ構造が含まれます。 すべての Early Descriptor FDLIDLST は、事前に作成されており、Db2 の一部です。読み取り専用の事前作成された構造からのローカル・コピーは、要求ベースで作成されます。 Late Descriptor をサポートする FDLIDLST は、記述子の処理中に動的に作成されます。
データ・ストリームから取得されるすべての FDOCA グループ (NULL 可能または NULL 不能) について、それぞれ 1 つの FDLIDLST があります。 Db2 のデータ転送単位は、FDOCA 行です。 各行には、1 つ以上のグループが含まれており、QW0191LT セクションは、行を構成しているすべてのグループを取得するために必要な FDLIDLST を収集します。 QW0191LT セクションに含まれている場合、FD_LIDENT_PTR フィールドのコンテンツは、その項目について処理されるデータの開始点のデータ・ストリーム (QW01916B セクション) に対するオフセットです。
QW01916B セクションの読み方
QW01916B セクションには、レベル 6b ヘッダーが含まれており、RQSDSS、RPYDSS、または OBJDSS データ・ストリームとその後に続くデータ・ストリームが定義されています。
