DBCACNX Fields|D8XCELEM|D8XCED - DBCACNX Fields - 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
Language
English (United States)
Last Update
2024-05-14
dita:mapPath
bmn1691484839905.ditamap
dita:ditavalPath
obe1474387269547.ditaval
dita:id
fvz1470444150352
Product Category
Teradata Tools and Utilities
The DBCACNX consists of two logical sections:
  • Header
  • Element

One header always exists and is followed by one or more elements. If data is associated with an element, it may either be included with the element or pointed to by the element. More than one extension may be chained together.

Header

Level should be set to 2.



A structure DBCACNX is defined in the dbcacnx.h file with this format.

DBCACNX Element Fields when Level is set to 2.



Structures 'D8XCELEM' and ‘D8XCED’ are defined in the dbcacnx.h file with this format.

The sections that follow describe each of the fields, in alphabetical order.

Data-length

Data-length is a four-byte unsigned integer field into which the length of the data is placed. If no data is associated with this type, the field is zero.

Structure Member Name
D8XCED d8xcedLn

Data-pointer

Data-pointer is a four-byte field into which the pointer to the data is placed. If either there is no data associated with this type or the data is included in the element, the field is zero or null.

Structure Member Name
D8XCED d8xcedPt

Data-type

Data-type is a two-byte unsigned integer field into which the type of data is placed.

Structure Member Name
D8XCED d8xcedTy
The following types are supported:
  • 1, for Client Userid (mnemonic DBXCEDTU)
  • 2, for Client Password (mnemonic DBXCEDTP)
  • 3, for Client Domain (mnemonic DBXCEDTD)

Element-length

Element-length is a two-byte unsigned integer field into which the length of the element is placed.

Structure Member Name
D8XCELEM d8xceLen

Element-type

Element-type is a two-byte unsigned integer field into which the type of element is placed. Currently, there is only one type of element, a data element with a type of 0.

Structure Member Name
D8XCELEM d8xceTyp

Eyecatcher

Eyecatcher is a four-byte field into which the ASCII characters 'CNX ' must be placed.

Structure Member Name
D8CACNX d8xcId

Length

Length is a four-byte unsigned integer field into which the total length of the extension is placed. The length includes the header fields, the fields of all elements, and any in-line data for the elements.

Structure Member Name
D8CACNX d8xcLen

Level

The Level field specifies the format of the extension.

The current level is 2. New development should use only the level 2 form. The level 1 form is deprecated.

Structure Member Name
D8CACNX d8xcLvl

Next-pointer

Next-pointer is a four-byte (32-bit) or an eight-byte (64-bit) field into which the pointer to the next Connect-extension is placed. If another Connect-extension does not exist, the field is zero or null.

Structure Member Name
D8CACNX d8xcNext