Fetch-returned-data-length - Call-Level Interface Version 2

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

Product
Call-Level Interface Version 2
Release Number
16.10
Published
May 2017
Language
English (United States)
Last Update
2018-05-07
dita:mapPath
jen1488824663137.ditamap
dita:ditavalPath
Audience_PDF_include.ditaval
dita:id
B035-2417
lifecycle
previous
Product Category
Teradata Tools and Utilities

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, 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

The following table shows how the location and meaning of “length” varies depending upon mode settings.

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.