Elements|CLIv2 - Elements - Call-Level Interface Version 2

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

Deployment
VantageCloud
VantageCore
Edition
Enterprise
IntelliFlex
Lake
VMware
Product
Call-Level Interface Version 2
Release Number
20.00
Published
January 2024
ft:locale
en-US
ft:lastEdition
2024-11-15
dita:mapPath
bmn1691484839905.ditamap
dita:ditavalPath
obe1474387269547.ditaval
dita:id
fvz1470444150352
lifecycle
latest
Product Category
Teradata Tools and Utilities
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.



This 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..