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

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.