15.10 - ExtendedKeepRespond - Call-Level Interface Version 2

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

prodname
Call-Level Interface Version 2
vrm_release
15.10
category
Programming Reference
featnum
B035-2417-035K

Purpose

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

Usage Notes

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

If the ExtendedKeepResponse 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 Teradata 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 Response parcel
  • An abort operation occurs
  • A logoff operation occurs
  • This parcel is generated by CLIv2 at the direction of the application.

    Parcel Data

    Table 86 provides field information about the ExtendedKeepResponse parcel.

     

    Table 86: ExtendedKeepResponse Parcel Field Information

    Flavor

    Parcel Body Length

    Parcel Body Fields

    154

    4

    MaxMsgSize: 4 byte unsigned integer

    Note: 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. The maximum value is 4294967295.

    Whether the ExtendedKeepRespond parcel is supported by the Database can be ascertained using the CLIv2 DBCHQE Extended‑response‑support query.