Fetch Data Pointer, Move 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 Move Mode, that is, when Locate Mode is set to N and Parcel Mode Fetch is set to Y or N, Fetch Data Pointer is the field where the application program specifies the address of its Move area before calling DBCHCL for the Connect, Run Startup, or Initiate Request functions.

If Fetch Maximum data length is less than the actual data to be returned by CLI, CLI will return a BUFOVFLOW error.

Variable length fetch should not be set to 'Y' when parcel mode is set to 'N'.

If Parcel Mode is used with Move Mode, that is, Parcel Mode is set to Y and Locate Mode is set to N, when DBCHCL is called for the Connect, Run Startup, or Initiate Request function, and if Variable Length Fetch is set to:
  • Y, CLI copies the two-byte length field that precedes the Parcel body into the address specified in Fetch Data Pointer.
  • N, CLI copies the parcel body into the address specified in Fetch Data Pointer.
If Buffer mode is used with Move mode, that is, if Locate mode is set to N and Parcel Mode Fetch is set to N:
  • Variable Length Fetch must be set to N, and
  • CLI copies one buffer full of response into the address specified in Fetch Data Pointer.
Routine Action Taken
DBCHINI: writes
DBCHCL: reads (FET)
Used by Action Taken
application program writes (FET)