When the value for Two-response-buffers is not appropriate for the application, you should perform the following procedure before calling DBCHCL for any of the following functions:
- Connect
- RunStartUp
- Initiate with Protocol-Function
- Initiate Request
- Set Change-options to 'Y'.
-
Change the value for Two-response-buffers as follows.
If the response is to be... Then change the value for Two-response-buffers to... double-buffered Y single-buffered N
Use mnemonics for the codes. Mnemonics are provided in the language definition file for the DBCAREA.
Double buffering is useful when large responses are expected from the Teradata Database and large response buffers are used.
Substantial improvements in response time can result by transferring the next buffer full of response data from the Teradata Database while the previous buffer full is being accessed by the application.
DBCHCL automatically restocks the response buffers.
The application may have to wait for data to arrive if the application is consuming the data faster than the Teradata Database can restock the buffer, but it does not have to arrange for data to arrive.
Although the value of Two-response-buffers is read and stored by the Connect function, it is not used for the connect operation itself.
When a non-zero Row-count is specified, the Two-response-buffers option should probably be set to 'N' because 'Y' is used to maximize fetching performance while Row-count is used to reduce it.