The DDIS FDLIDLST structure

Every FDOCA array consists of one or more FDOCA rows and all FDOCA rows represent elements of an FDOCA group.

Command and reply data are either described as FDOCA rows or arrays. Db2 creates data structures to support data retrieval of DDM command/reply data objects that are described by an Early or Late Row Descriptor. This data structure is a list of FDOCA Local Identifiers (LIDs) and is called an FDLIDLST. A collection of FDLIDLST structures is created for every FDOCA row to be retrieved from command or reply data. Thus, the Db2 unit of data transfer is an FDOCA row.

An FDOCA row is an ordered collection of elements of an FDOCA group. FDOCA groups are recursive. The elements are other FDOCA groups or Simple Data Arrays (SDAs). The DRDA objects that are described by FDOCA are usually defined in terms of nullable groups, that is all elements of the group are present in the object if the group null indicator value is 0, or none of the elements of the group are present in the object if the group null indicator value is positive (empty set).

An FDOCA group might be modeled as a tree such that the root represents the group occurrence and nonterminal nodes represent other FDOCA groups. Terminal nodes consist of Simple Data Arrays (SDAs), and always represent a datum of a unique DRDA data type. Given an FDOCA row, which orders the elements of an FDOCA group, G, there is a (parent) FDLIDLST representing G (root node) and an FDLIDLST for each non-terminal group that is contained within G. Terminal nodes up consist of SDAs and always represent a datum of a unique DRDA data type. The hierarchical (tree) structure of the FDOCA group is represented by one or more FDLIDLSTs. Each FDLIDLST retrieves the subset of the data that is described by the parent FDLIDLST.

The FDLIDLST header defines the total number of elements (GDAs or SDAs) comprising the group. This is followed by one LIDENT entry for each of these elements. The LID is stored in LIDENTLI and the DRDA type (SDA or GDA) is stored within LIDENTTY. The entry defines an SDA (terminal node) if the DRDA type (LIDENTTY) is less than X'50'. In this case, the value of LIDENTO1 is the offset relative to the Level 6b data stream (QW01916B) of the source data. If the value of LIDENTTY is greater than X'50', the entry represents a non-terminal node (another group) and the value of LIDENTO1 is the offset relative to the 0191 record of the child FDLIDLST, which describes that group.