Late Descriptor の FDLIDLST 構造
いくつかの FDLIDLST 構造は、Early Descriptor によって記述されたオブジェクトを取得します。
SQLDTARD
SQLDTARD 配列は、SQLCADTA 行のオープン配列です。
各 SQLCADTA 行は、SQLCAGRP (DRDA タイプは X'54) のすべてのオカレンスと、それに続く、NULL 可能 SQLDTAGRP で定義された LID のすべてのオカレンスから構成されます。
SQLDTAGRP に N 個のエレメント (トリプレット) が含まれている場合、FDLIDLST は以下の項目から構成されます。
- 単一項目が含まれる親 SQLCAGRP FDLIDLST。
- 3 つの終端 SDA および非終端 GDA が含まれ、従属 SQLCAXGRP FDLIDLST を指す子 FDLIDLST。
- SQLCAXGRP を取得するための 20 個の終端 SDA が含まれる SQLCAXGRP 従属 FDLIDLST。
- 単一項目 (DRDA タイプは X'D0') が含まれ、子 SQLDTAGRP FDLIDLST を指す親 FDLIDLST。
- それぞれが終端 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'