15.10 - Two Response Buffers - Call-Level Interface Version 2

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

prodname
Call-Level Interface Version 2
vrm_release
15.10
category
Programming Reference
featnum
B035-2417-035K

Two Response Buffers is a one byte field that specifies whether double‑buffering is to be used for the response.

 

In this language...

The variable name for Two Response Buffers is...

COBOL

DBCAREA‑TWO‑RESP‑BUFS

PL/I

TWO_RESP_BUFS

C

two_resp_bufs

IBM Assembler

DBO2FBU

 

This routine...

Does this for Two Response Buffers...

DBCHINI

writes

DBCHCL

reads (CON; RSUP; IWPF; IRQ)

 

Two Response Buffers is used by...

To...

applications

write

Two Response Buffers is initialized by DBCHINI to the default value provided for Two Response Buffers in the HSHSPB.

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
  • 1 Set Change Options to 'Y'.

    2 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.

    Note: The response for the connect request is not double‑buffered, even if Two Response Buffers is set to ‘Y‘, when DBCHCL is called for the Connect function. However, any other request‘s responses on that session are double buffered, unless the setting of Two Response Buffers is changed before the request is submitted.

    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.