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