15.10 - Fetch Returned Data Length - 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

Fetch Returned Data Length is a four-byte field that specifies the length in bytes of the returned data.

 

In this language...

The variable name for Fetch Returned Data Length is...

COBOL

DBCAREA‑FET‑RET‑DATA‑LEN

PL/I

FET_RET_DATA_LEN

C

fet_ret_data_len

IBM Assembler

DBFOFDL

 

This routine...

Does this for Fetch Returned Data Length...

DBCHINI

writes

DBCHCL

writes (FET)

 

Fetch Returned Data Length is used by...

To...

applications

read

After a call to DBCHCL for the fetch function, an application can obtain the length of the returned data. Where the length is provided and what the length refers to depends on the settings in effect when DBCHCL is called for any of the following functions:

  • Connect
  • RunStartUp
  • Initiate Request
  • Table 6 shows how the location and meaning of “length” varies depending upon mode settings.

     

    Table 6: Length of Returned Data 

    Locate Mode

    Parcel Mode Fetch

    Variable Length Fetch

    Length of What?

    Where Length is Provided

    Y or N

    Y

    N

    Parcel body

    Fetch Returned Data Length

    Y or N

    Y

    Y

    Parcel body

    The first two bytes at the address in Fetch Data Pointer

    Y

    N

    N

    The grand total of all parcels (headers and bodies) in the response buffer

    Fetch Returned Data Length

    Y

    N

    Y

    Nothing. These settings produce an error.

     

    DBCHCL places Fetch Returned Data Length, if used, in the DBCAREA when the Fetch function completes. Thus, Fetch Data Pointer is available when an application regains control with a return code of zero from a call to DBCHCL for the Fetch function.