16.20 - Parcel Header - Teradata Tools and Utilities

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

prodname
Teradata Tools and Utilities
vrm_release
16.20
created_date
September 2019
category
Programming Reference
featnum
B035-2417-108K

There are two formats of parcel headers. The parcel headers are symbolically defined in the TC2XPH file. The format of the first is:



Original Parcel Header (TPH0)
Field Name Offset Length Description
PH0FLAVR (FLAVOR-FLAG for COBOL 'flavor' for C, and PL/I) 00 1 bit A binary zero, indicating this header format. The mnemonic for the bit is PH0FALT ('Tc2ph_Alternate' for C, TPH0_ALTERNATE for PL/I)
PH0FLAVR ('flavor' for COBOL, C, and PL/I) 0.1 15 bits An unsigned integer identifying the type of parcel body.
PH0LEN ('length' for C and PL/I) 02 2 bytes An unsigned integer specifying the length of the parcel, in bytes, including the parcel header and any body.

The format of the second is:



Alternate Parcel Header (TPH1)
Field Name Offset Length Description
PH1FLAVR (FLAVOR-FLAG for COBOL 'flavor' for C and PL/I) 00 1 bit A binary zero, indicating this header format. The mnemonic for the bit is PH1FALT ('Tc2ph_Alternate' for C, TPH1_ALTERNATE for PL/I)
PH1FLAVR ('flavor' for COBOL, C, and PL/I) 0.1 15 bits An unsigned integer identifying the type of parcel body.
PH1FILL1 ('fill1' for COBOL, C, and PL/I) 02 2 bytes Not used: Set to binary zeroes.
PH1LEN ('length' for C and PL/I) 04 4 bytes An unsigned integer specifying the length of the parcel, in bytes, including the parcel header and any body.

A response will only contain a parcel with the enlarged header if the APH-response-permitted option was specified and the Teradata Database supports the alternate header for that parcel. Furthermore, parcels whose length is less than or equal to 65535 may use either header format.