Changing the Value for Maximium Parcel - Call-Level Interface Version 2

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

Deployment
VantageCloud
VantageCore
Edition
Enterprise
IntelliFlex
Lake
VMware
Product
Call-Level Interface Version 2
Release Number
20.00
Published
January 2024
ft:locale
en-US
ft:lastEdition
2024-11-15
dita:mapPath
bmn1691484839905.ditamap
dita:ditavalPath
obe1474387269547.ditaval
dita:id
fvz1470444150352
lifecycle
latest
Product Category
Teradata Tools and Utilities

Maximum Parcel is initialized to the default value provided for Maximum Parcel in the site’s CLISPB. If the value is not appropriate for the application, perform the following before calling DBCHCL for Connect, Run Startup and Initiate Request:

  1. Set Change Options to 'Y'.
  2. Change the value as appropriate.
    • O, if the original limit of 32 KB is the maximum size of one parcel.
    • H, if the limit of 64 KB or 1 MB (APH-requests/extended response support exists at the server) is the maximum size of one parcel.
    When the actual row size to be returned is:
    • Less than 32 KB and the response buffer is not large enough to hold a parcel, the Teradata server returns a 3116 error. In response, CLI will retry with a larger buffer size.
    • Greater than 32 KB and the response buffer is not large enough to hold a parcel, the Teradata server returns a 3115 error. CLI will retry with a larger buffer size only if Maximum Parcel is set to H. If Maximum Parcel is set to O, CLI will not retry the 3115 error with a larger buffer size, but will return the 3115 error to the user. This prevents retry looping.
    • Greater than 64 KB and the response buffer is not large enough to hold a parcel, the Teradata server returns a 3177 error followed by an ErrorInfo parcel with an InfoType of 1 (PCLBUFFERSIZE). CLI will retry with a larger buffer size only if Maximum Parcel is set to H. If Maximum Parcel is set to O, CLI will not retry the 3177 error with a larger buffer size, but will return the 3177 error to the user. This prevents retry looping.