15.10 - Rewinding to the Beginning of a Response - Call-Level Interface Version 2

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

Call-Level Interface Version 2
Programming Reference

The response for a request may be reprocessed from the beginning if an application requires. The ability to rewind to the start of the response sequence is dependent on the setting of the Keep Response option when the request is initiated.


Keep Response



The response is discarded as it is processed and rewind is unavailable.


The application has the option of rewinding to the beginning of the response and reprocessing.

To rewind to the start of the response after the session has been established, an application must performs the following steps:

1 Modify the DBCAREA.

a Set the Function to Rewind.

b Set the Input CLIv2 Session Id used to initiate the request.

c Set the Input CLIv2 Request Id to the Output CLIv2 Request Id obtained when the request was initiated.

d Optionally set the following:

  • Message Area Pointer
  • Message Area Length
  • 2 Call DBCHCL to perform the Rewind function.

    3 Check the return code from DBCHCL:


    Return Code



    Call DBCHCL to perform a Fetch function (see “Fetching the Response for a Request” on page 58) to get the final status of the rewind and the first part of the response.

    anything else

    Process the return code and DBCAREA message.