17.10 - Elements - Call-Level Interface Version 2

Teradata® Call-Level Interface Version 2 Reference for Workstation-Attached Systems

Product
Call-Level Interface Version 2
Release Number
17.10
Release Date
October 2021
Content Type
Programming Reference
Publication ID
B035-2418-061K
Language
English (United States)
Immediately following the header are one or more elements. Each element will either:
  • Contain the actual data
  • Address the actual data

When the Eyecatcher field contains 'IRX8' and the Level field contains a value of 1, there is one element format, which either contains the data or addresses the data. New development should use only a Level of 1; a value of 0 is deprecated. These elements are described by the following figure.



The above format is implemented using two structures 'D8XIELEM' and 'D8XIEP' in the dbcarea.h file, provided during installation. When either the Eyecatcher field contains 'IRX8' and the Level field contains a value of 0, or the Eyecatcher field contains 'DBCX', there are two element formats:
  • Inline format contains data.
  • Pointer format addresses the data.

Inline Method

The element type field in the Element header indicates whether the parcel body will follow the header or a pointer element will follow the header. For information on setting Inline and Pointer methods, see Element Type.

If Eyecatcher is set to 'IRX8' and Level field is set to 0 in the extension header (D8CAIRX) or if the Eyecatcher is set into 'DBCX' in Extension header (DBCAREAX), the following is format in which the parcel is sent in Inline method.



If 'IRX8' with level 0 is used, then the structure defined for this purpose is 'D8XILMNT'.

If 'DBCX' eyecatcher is used, then the structure defined for this purpose is 'x_element'.

Pointer Method

If Eyecatcher is set to 'IRX8' and Level field is set to 0 in the extension header (D8CAIRX8), the following is the format in which the parcel is sent in the Pointer method.



The structure defined for this purpose is 'D8XILPTR' and is available in dbcarea.h.

If Eyecatcher is set to 'DBCX' in the extension header (DBCAREAX), the following is the format in which the parcel is sent in Pointer method.



The structure defined for this purpose is 'xp_element' and is available in dbcarea.h..