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
16.10
Published
May 2017
Language
English (United States)
Last Update
2018-05-01
dita:mapPath
ggf1488824663364.ditamap
dita:ditavalPath
Audience_PDF_include.ditaval
dita:id
B035-2418
lifecycle
previous
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.