Late Descriptor の FDLIDLST 構造

いくつかの FDLIDLST 構造は、Early Descriptor によって記述されたオブジェクトを取得します。

SQLDTARD

SQLDTARD 配列は、SQLCADTA 行のオープン配列です。 各 SQLCADTA 行は、SQLCAGRP (DRDA タイプは X'54) のすべてのオカレンスと、それに続く、NULL 可能 SQLDTAGRP で定義された LID のすべてのオカレンスから構成されます。 SQLDTAGRP に N 個のエレメント (トリプレット) が含まれている場合、FDLIDLST は以下の項目から構成されます。
  1. 単一項目が含まれる親 SQLCAGRP FDLIDLST。
  2. 3 つの終端 SDA および非終端 GDA が含まれ、従属 SQLCAXGRP FDLIDLST を指す子 FDLIDLST。
  3. SQLCAXGRP を取得するための 20 個の終端 SDA が含まれる SQLCAXGRP 従属 FDLIDLST。
  4. 単一項目 (DRDA タイプは X'D0') が含まれ、子 SQLDTAGRP FDLIDLST を指す親 FDLIDLST。
  5. それぞれが終端 SDA を表す N 個の項目が含まれる子 FDLIDLST。

FDLIDLST 構造は以下のとおりです。

FDLIDLST DSECT
FDLIDCNT DS    F           Total # LIDs this Group
*                          Each LID is described by one
*                          LIDENT entry. The LIDENT entries
*                          are contiguous to FDLIDLST.
FDLIDLST DS    F           Last LIDLSTE processed
FDLIDF   DS    X           Flag byte
*                          '80'X Optimization Flag
         DS    XL3         Reserved
FDLIDMX  DS    F           Max length if FDLIDF='80'X
         DS    XL8         Reserved
FDLIDHLL EQU   *-FDLIDLST  Sizeof(FDLIDLST header)
*****************************************************************
*   Define Mapping for LID element within FDLIDLST.             *
*   There is one LIDENT for each of the total number of LIDs    *
*   specified by FDLIDCNT. The LIDENTs follow FDLIDLST.         *
*****************************************************************
LIDENT   DSECT                   FDOCA LID entry Mapping
LIDENTLI DS    X                 FDOCA LID to be processed
*                                this is identical to DRDA type
*                                unless described by a Late
*                                Environmental Descriptor
LIDENTTY DS    X                 DRDA Type (GDA or SDA)
LIDENTFD DS    X                 FDOCA Data Type Representation
LIDENTNU DS    X                 Null Byte if nullable
LIDENTLT DS    F                 Length of data in bytes
*                                upper bound for variable
LIDENTO1 DS    F                 If LIDENTTY >= X'50' then offset
*                                relative to 0191 record to child
*                                FDLIDLST. If LIDENTTY < X'50'
*                                then offset relative to objdss
LIDENTO2 DS    F                 Offset if partial object
LIDENTVA DS    X                 High Order Byte if Variable
*                                data and LIDENT state is SV2
LIDENTST DS    X                 FD_LIDENT State
*                                values are defined below
LIDENTVR DS    X                 0 - data is not variable
*                                1 - data is variable with
*                                    halfword prefix
*                                2 - data is variable null
*                                    terminated
*                                3 - data is variable with
*                                    one-byte prefix
LIDENT37 DS    X                 0 - data is numeric,
*                                    representation is S/370
*                                1 - data is numeric,
*                                    representation is 80X86
*                                2 - data is numeric,
*                                    representation is /400
LIDENTAL DS    F                 Actual size of object (may differ
*                                from LIDENTLT is data is variable
LIDENTSD DS    F                 0
LIDENTRT DS    A         Data routine or 0
LIDENTDL DS    F          Max length of data or 0
LIDENTF   DS    X          Flag
                                 '80'X  Data is placeholder
         DS    XL3               Reserved
LIDENTLL EQU   *-LIDENT          Sizeof(LIDENT)
******************************************************************
*  Define LIDENT states:                                         *
*        State   0: Initial/Final State                          *
*  NOTE:                                                         *
*     States SV1, SV2, SV3, SN1 and SN2 are only valid           *
*     if the data described by the LIDLST may span multiple      *
*     DDM objects. This is only true if the LIDLST describes     *
*     row data which is being processed via Limited Block        *
*     protocols. In this case, row data may span multiple        *
*     query blocks, each of size qryblksz, each containing       *
*     one qrydta object.                                         *
*                                                                *
*     For fixed data, the size of the datum is determined from   *
*     the size specified by the DRDA SDA specification, or       *
*     if a Late Descriptor, from a length override. Once spec-   *
*     ified, the length cannot change. For variable data, the    *
*     size specified from the DRDA SDA specification or length   *
*     override is an upper bound (a maximum). The actual length  *
*     of the datum is transmitted as a halfword preceding the    *
*     datum. Thus, it is possible that all or part of the half-  *
*     word prefix is transferred in block n and the remainder    *
*     is transferred in other blocks.                            *
*     The following LIDENT states support partitioning of        *
*     the null indicator (if nullable), halfword length pre-     *
*     fix and data.                                              *
*                                                                *
*     State SV1: Variable Data - 0 bytes of halfword ll          *
*     State SV2: Variable Data - 1 byte  of halfword ll          *
*     State SV3: Variable Data - 2 bytes of halfword ll - no     *
*                                data retrieved                  *
*     State SN1: Nullable Data - Null Indicator not available    *
*     State SN2: Nullable Data - Null Indicator available - no   *
*                                data retrieved                  *
******************************************************************
*
LIDST0   EQU   X'00'
LIDSTV1  EQU   X'01'
LIDSTV2  EQU   X'02'
LIDSTV3  EQU   X'03'
LIDSTV4  EQU   X'04'
LIDSTN1  EQU   X'10'
LIDSTN2  EQU   X'20'
図 1. FDLIDLST 構造