Within the database, a response to a request is kept within a spool file. To satisfy Fetch requests by an application, CLIv2 interacts with the database to obtain all or part of the spooled response. How long the response is spooled and how it is processed is controlled by the application, as follows.
Specified Option | Result |
---|---|
Keep-response=N | The response is discarded after the last parcel is fetched, and parcels may only be fetched once, in sequential order. |
Keep-response=Y | The response is kept until the EndRequest function is called, and parcels may be fetched in sequential order, the Rewind function called, and fetched again, the process repeated any number of times. |
Keep-response=Y and an SQL Select statement includes the FOR CURSOR phrase | The response is kept until the EndRequest function is called, and parcels may be fetched in random order by row, sequentially within that row using the CursorDBC and CursorHost parcels. |
Keep-response=P | The response is kept until the EndRequest function is called, and parcels may be fetched in random order by row, sequentially within that row using the Positioning-action, Positioning-statement-number, and Positioning-value DBCAREA settings. |