Fetch Data Pointer, Locate Mode - 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

Usage Notes

In Locate Mode, when Locate Mode is set to Y and Parcel Mode Fetch is set to N or Y, Fetch Data Pointer is the field where the application program can obtain the address of the returned data after calling DBCHCL for the Fetch function.

If Locate Mode is used, when DBCHCL is called for the Connect, Run Startup or Initiate Request function, and
  • If Parcel Mode is used, that is, if Parcel Mode Fetch was set to Y, and if Variable Length Fetch was set to:
    • Y, the address in Fetch Data Pointer points to the two-byte length field that precedes the returned data.
    • N, the address in Fetch Data Pointer points to the first byte of the parcel body.
  • If Buffer Mode is used, that is, if Locate Mode is set to Y and Parcel Mode Fetch is set to N,
    • Variable Length Fetch must be set to N, and
    • The address in Fetch Data Pointer points to the first byte of the buffer, which is the first byte of the parcel header of the first parcel.

In Locate Mode, DBCHCL places Fetch Data Pointer in the DBCAREA when the Fetch function completes. Thus, Fetch Data Pointer is available when the application program regains control with a return code of zero from a call to DBCHCL for the Fetch function.

Routine Action Taken
DBCHINI: writes
DBCHCL: writes (FET)
Used by Action Taken
application program reads (FET)