15.10 - Maximum Parcel - 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

Maximum Parcel is a one-byte field that specifies whether the maximum parcel length is 32767 or the maximum size supported by the server, up to 65535 bytes. For maximums beyond 65535, also specify the DBCAREA APH‑response‑OK option.

 

In this language...

The variable name for Maximum Parcel is...

COBOL

MAXIMUM‑PARCEL

PL/I

MAXIMUM_PARCEL

C

maximum‑parcel

IBM Assembler

DBCIMP

 

This routine...

Takes the action for Maximum Parcel...

DBCHINI

writes

DBCHCL

reads (CON; RSUP; IRQ; IWPF; CMD; CRQ)

 

Maximum Parcel is used by...

To...

applications

write.

Maximum Parcel is initialized to the default value provided for Maximum Parcel in the site‘s HSHSPB. If the value is not appropriate for an application, the application can, before calling DBCHCL for Connect, change the values as follows:

1 Set Change Options to ­'Y­'.

2 Change the value for Maximum Parcel as follows:

 

If...

Then change the value for Maximum Parcel
to...

the original limit of 32767 is the maximum size of one parcel

O

if the higher limit of 2,147,483,647 bytes is the maximum size of one parcel

H

Note: For new applications, Maximum‑parcel=H should always be specified.

Use mnemonics for the codes. Mnemonics are provided in the language definition file for the DBCAREA.

A Maximum‑parcel value of 'H' is required for a Response‑buffer‑length greater than 32767. If the server requires a response buffer larger than 65535 bytes but Maximum‑parcel is not set to H, then an Error parcel with error code 3177 will be returned.