Fetch Error Indicator - Call-Level Interface Version 2

Teradata® Call-Level Interface Version 2 Reference for Workstation-Attached Systems - 20.00

Deployment
VantageCloud
VantageCore
Edition
Enterprise
IntelliFlex
Lake
VMware
Product
Call-Level Interface Version 2
Release Number
20.00
Published
January 2024
ft:locale
en-US
ft:lastEdition
2024-11-15
dita:mapPath
bmn1691484839905.ditamap
dita:ditavalPath
obe1474387269547.ditaval
dita:id
fvz1470444150352
lifecycle
latest
Product Category
Teradata Tools and Utilities

Usage Notes

The Fetch Error Indicator field specifies the status of the move in Move Mode.

Language Variable Name
COBOL: DBCAREA-FET-ERROR-IND
C: DBCAREA.H: fet_error_ind
Routine Action Taken
DBCHINI: writes
DBCHCL: writes (FET)
Used by Action Taken
application program reads

After a call to DBCHCL for the Fetch function and the request was issued with Move Mode in effect, the application program can obtain an indicator of the success of the move. If the Move area is too small to hold the parcel, Fetch Error Indicator is set to 0xFF; otherwise, Fetch Error Indicator is set to 0x00.

If Fetch Error Indicator is set to 0xFF after a call to DBCHCL for the Fetch function in Move Mode, the application program may re-allocate the Move area so that it is at least as long as the value in Fetch Returned Data Length. It may then re-issue the call to DBCHCL for the Fetch function.

DBCHCL places Fetch Error Indicator in the DBCAREA when the Fetch function completes. Thus, Fetch Error Indicator is available when the application program regains control with a return code of zero from a call to DBCHCL for the Fetch function. The application should check this field, in case CLI returns with BUFOVFLOW to confirm that it needs to re-allocate its Move area as notified by CLI in Fetch Returned Data Length.