DDIS RDTA 構造

データ・ストリームから取得するすべての FDOCA 行に、1 つの親 FDLIDLST 構造と 1 つ以上の子 FDLIDLST が存在します。 これは、Early FDOCA Row および Late FDOCA Row に当てはまります。ただし、Late Descriptor をサポートするために 2 番目のデータ構造 (DDIS RDTA 構造) が作成されます。

2 つの DRDA Late Descriptor が定義されています。SQLDTA は、EXCSQLSTT または OPNQRY のサポートで送信されるホスト変数を記述し、SQLDTARD は、OPNQRY あるいは EXCSQLSTT から返される応答セットを記述しています。 どちらの記述子も、Late Group Descriptor SQLDTAGRP を中心に構築された単純な構造をしています。

SQLDTA Late Descriptor は、SQLDTAGRP から構築されており、入力ホスト変数を記述しています。 この記述子は、入力 SQLDA にマップされています。同様に、SQLDTARD (これも SQLDTAGRP から構築されています) は、設定されている出力応答を記述し、出力 SQLDA にマップされています。 RDTA 構造は、SQL データ・タイプ、長さ、および文字表現 (CCSID) の観点から、SQLDTAGRP エレメント (SDA) を関連付けます。

RDTA 構造は、以下の図に示されています。RDTALID には、Late SQLDTA/SQLDTARD によって記述されたデータを取得するために必要な親 SQLDTAGRP FDLIDLST 構造のアドレスが含まれます。 SQLDTAGRP に含まれているすべてのトリプレットについて、RDTAENT エレメントが存在しており、その DRDA データ・タイプの SQL 属性を定義しています。

図 1. RDTA 構造
RDTA     DSECT                  Relational Data Block
RDTAID   DS    H                RDTA ID
RDTALEN  DS    H                RDTA Length
RDTAEYE  DS    CL4              RDTA Eye Catcher
RDTDA  DS    A                A(DB2 Sqlda)
RDTALID  DS    F                offset within 0191 record
*                               of QW0191LT section
RDTAROW  DS    A                A(Input Host Variables)
RDTALED  DS    0XL4
RDTAGLID DS    X                SQLDTAGRP RLO LID and
*        DS    XL2              Reserved
RDTANUM  DS    F                Total Number RDTAENT slots
RDTANPH  DS    F                Number of placeholders
RDTAFLG  DS    X                Flag
                                '80'X  RDTARAWP is used
         DS    XL3              Reserved
RDTALL   EQU   *-RDTA           Sizeof(RDTA Header)
*
RDTAENT  DSECT                  RDTA Entry Mapping - one entry for
*                               each SDA processed in sqldtagrp
RDTTYP DS    H                SQLTYPE
RDTUBT DS    H                SQLSUBTYPE
RDTACCSI DS    XL2              Derived CCSID
RDTALGTH DS    0H               SQL Length
RDTALEN1 DS    X                Decimal Precision
RDTALEN2 DS    X                Decimal Scale
RDTAFLG1 DS    X                Flag
                                        '80'X  Placeholder only
                                        '40'X  Mapped type
         DS    X                     Reserved
RDTAOTYP DS    H              Original SQLTYPE, if mapped
RDTARAWP DS    A             Raw data pointer, if mapped
         DS    XL4                  Reserved
RDTALL   EQU   *-RDTAENT        Sizeof(RDTAENT)