Fetch Data Pointer—Locate Mode - Call-Level Interface Version 2

Teradata Call-Level Interface Version 2 Reference for Mainframe-Attached Systems

Product
Call-Level Interface Version 2
Release Number
15.00
Language
English (United States)
Last Update
2018-09-28
dita:id
B035-2417
lifecycle
previous
Product Category
Teradata Tools and Utilities

Fetch Data Pointer—Locate Mode

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

 

This routine...

Does this for Fetch Data Pointer in Locate Mode...

DBCHINI

writes

DBCHCL

writes (FET)

The following table explains how Fetch Data Pointer works in Locate Mode (Locate Mode = ‘Y‘) when DBCHCL is called for the following functions:

  • Connect
  • RunStartUp
  • Initiate with Protocol‑Function
  • Command
  • Initiate Request.
  •  

    If you use this mode...

    And you set Variable Length Fetch in DBCAREA to this value...

    And you set Parcel Mode Fetch in DBCAREA to this value...

    Then the address in Fetch Data Pointer points to the...

    parcel

    N

    none

    first byte of the parcel body.

    parcel

    Y

    none

    two byte length field that precedes the returned data.

    buffer

    N

    N

    first byte of the buffer, which is the first byte of the parcel header of the first parcel.

     

    In Locate Mode, Fetch Data Pointer is used by...

    To...

    applications

    read (FET)