KeepRespond - Teradata Tools and Utilities

Teradata® Call-Level Interface Version 2 Reference for Mainframe-Attached Systems
Product
Teradata Tools and Utilities
Release Number
17.10
Published
June 2021
Language
English (United States)
Last Update
2021-07-01
dita:mapPath
zwv1608578409227.ditamap
dita:ditavalPath
obe1474387269547.ditaval
dita:id
B035-2417
Product Category
Teradata Tools and Utilities

Purpose

Conveys the current length of the input (response) buffer.

Usage Notes

The KeepRespond parcel requests as many response parcels as will fit in the specified MaxMsgSize.

If the KeepRespond parcel is used in a start request or continue request and the start response or continue response contains the EndRequest parcel, the spool file is retained on the database.

In general, the spool file is deleted in any of the following situations:
  • A Cancel parcel is issued
  • The EndRequest parcel is returned in response to a continue request that contained a Resp parcel
  • An abort operation occurs
  • A logoff operation occurs

This parcel is generated by CLIv2 at the direction of the application.

Parcel Data

The following table provides field information for the KeepRespond parcel.

Flavor Field Parcel Body Length Parcel Body Fields
5 2 MaxMsgSize: 2-byte unsigned integer
  • MaxMsgSize is the maximum number of bytes that can be returned to the client in one response. The minimum allowable buffer size is 256 bytes, hence MaxMsgSize must be greater than or equal to 256.
  • MaxMsgSize must be less than or equal to the size of the input (response) buffer.
  • If the next parcel to be returned by the database is larger than MaxMsgSize, an Error parcel that specifies how large the buffer must be is returned. If the buffer size is too small, a larger buffer must be allocated by the application program. The maximum value is 65535.

The KeepRespond parcel is supported by all versions of Vantage and Teradata Database.