In the Locate-mode, DBCHCL places Fetch-data-pointer in the DBCAREA when the fetch function completes. Thus, Fetch-data-pointer is available when the application regains control with a return code of zero from a call to DBCHCL for the fetch function.
| This routine... | Does this for Fetch-data-pointer in Locate-mode... |
|---|---|
| DBCHINI | writes |
| DBCHCL | writes (FET) |
The following table explains how Fetch-data-pointer works in Locate-mode (Locate-mode = ‘Y‘) when DBCHCL is called for the following functions:
- Connect
- RunStartUp
- Initiate with Protocol-Function
- Command
- Initiate Request.
| If you use this mode... | And you set Variable-length-fetch in DBCAREA to this value... | And you set Parcel-mode-fetch in DBCAREA to this value... | Then the address in Fetch-data-pointer points to the... |
|---|---|---|---|
| parcel | N | none | first byte of the parcel body. |
| parcel | Y | none | two byte length field that precedes the returned data. |
| buffer | N | N | first byte of the buffer, which is the first byte of the parcel header of the first parcel. |
| In Locate-mode, Fetch-data-pointer is used by... | To... |
|---|---|
| applications | read (FET) |