16.20 - Response Repositioning - Teradata Tools and Utilities

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

prodname
Teradata Tools and Utilities
vrm_release
16.20
created_date
September 2019
category
Programming Reference
featnum
B035-2417-108K

Within Teradata Database, a response to a request is kept within a spool file. To satisfy Fetch requests by an application, CLIv2 interacts with Teradata 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.