16.20 - DBCHCL REW Function - 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

Purpose

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
Input-CLIv2-connection-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