Using Data Pointer - 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

Usage Notes

The Using Data Pointer field specifies the address of the data string that is referred to by the USING clause in the request string. DBCHCL does not parse the request string. It is the application program’s responsibility to be certain that a data string exists and that it is pointed to by Using Data Pointer if a USING clause is in the request string.

Language Variable Name
COBOL: DBCAREA-USING-DATA-PRT
C: DBCAREA.H: using_data_ptr
Routine Action Taken
DBCHINI: writes
DBCHCL: reads (IRQ)
Used by Action Taken
application program writes
Before calling DBCHCL for the Initiate Request function and if the request string contains a USING clause, the database application program must build a data string that contains the data described by the USING clause.
  • If the data cannot contain null values, the application program sets Use Presence Bits to 'N' in the DBCAREA.
  • If the data can contain null values, the application program inserts bytes containing indicator bits (one per column) at the front of the data string and sets Use Presence Bits to 'Y'. See Use Presence Bits.

The application program must place the address of the first byte of presence bits or the first byte of the data string, if there are no presence bits, in Using Data Pointer.

If there is no USING clause in the request string, be certain that Using Data Length is set to zero; otherwise, whatever value is in Using Data Pointer is used as if it were a real address and may cause unpredictable errors.