dbpcbStream data structure

The distributed data management (DDM) architecture dbpcbStream is a data structure that is contained in the OUTAIBDBPCB reply object when the object is passed back in a reply message.

Format

The following table defines the format of the dbpcbStream data structure.

Note: The table shows some fields as having two possible starting byte offsets. For each these fields, if a database name is included in the dbpcbStream data structure, the field starts at the higher of the possible byte offsets.
Table 1. Format of the dbpcbStream data structure
Byte offset Length Name Description
0 1 DBPCB null indicator Binary integer.
X'00'
Indicates that the rest of the dbpcbStream data structure is present.
X'FF'
Indicates that the dbpcbStream data structure contains no data after the DBPCB null indicator. The total length of the dbpcbStream data structure is one byte.
1 1 Database name null indicator Binary integer.
X'00'
Indicates that a database name field is present at offset 2.
X'FF'
Indicates that a database name field is not present.
2 8 Database name Character string.
2 or 10 2 Segment level number Right-justified, numeric character data.
4 or 12 2 Status code Character data.
6 or 14 8 Segment name Character string.
14 or 22 1 Key feedback null indicator Binary integer.
X'00'
Indicates that a key feedback fields begin at offset 15 or, if a database name is present at offset 2, at offset 23.
X'FF'
Indicates that no key feedback fields are present.
15 or 23 4 Key feedback length Binary integer.
19 or 27 Variable Key feedback area Variable-length character string. The length of the key feedback area is defined in the key feedback length field at offset 15 or, if a database name is present in the dbpcbStream data structure, at offset 23.

Usage

When the Open Database Manager (ODBM) services a GU or GN call, ODBM returns requested data in rows defined within the data stream of a QRYDTA reply object. Each row begins with a concatenation of the aibStream and the dbpcbStream data structures followed by the requested data.