DBCHCL REW Function - Teradata Tools and Utilities

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

Product
Teradata Tools and Utilities
Release Number
16.20
Published
September 2019
Language
English (United States)
Last Update
2019-10-12
dita:mapPath
dsu1527114222346.ditamap
dita:ditavalPath
dsu1527114222346.ditaval
dita:id
B035-2417
lifecycle
previous
Product Category
Teradata Tools and Utilities

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