17.10 - Fetch Error Indicator - Call-Level Interface Version 2

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

Product
Call-Level Interface Version 2
Release Number
17.10
Release Date
October 2021
Content Type
Programming Reference
Publication ID
B035-2418-061K
Language
English (United States)

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.