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

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

prodname
Call-Level Interface Version 2
vrm_release
15.10
category
Programming Reference
featnum
B035-2417-035K

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)