16.20 - DBCHCL REW Function - Teradata Tools and Utilities

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

Teradata Tools and Utilities
September 2019
Programming Reference


REW (Rewind) repositions to the beginning of the response from the Teradata Database.

Keep-response must have been set to Y at the time of the Initiate Request for the request. Since Keep-response does not apply to Connect requests, the response to a Connect cannot be rewound.

Usage Notes

If Return Code is 0, the application may use FET to process the response.

DBCAREA Input Fields

Before using the Rewind function, the application must set the DBCAREA fields in the first table and may optionally set those in the second table depending on the application's requirements.

DBCAREA Input Fields Required for the Rewind Function
Function Input-CLIv2-request-number
DBCAREA Input Fields Optional for the Rewind Function
Message-area-length Message-area-pointer

DBCAREA Output Fields

Upon completion of the Rewind function, CLIv2 will always set DBCAREA fields in the first table and will set those in the second table if the function was successful.

DBCAREA Output Fields always set by the Rewind Function
Message-return-code Message-text
Message-length Message-text-length
Return Code