Fetch Returned Data Length
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:
Table 5 shows how the location and meaning of “length” varies depending upon mode settings.
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.