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.