Varying-length-request Option - Teradata Tools and Utilities

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

Deployment
VantageCloud
VantageCore
Edition
Enterprise
IntelliFlex
Lake
VMware
Product
Teradata Tools and Utilities
Release Number
17.20
Published
June 2022
ft:locale
en-US
ft:lastEdition
2023-11-17
dita:mapPath
oxw1641281447623.ditamap
dita:ditavalPath
obe1474387269547.ditaval
dita:id
vfj1470443597526
Product Category
Teradata Tools and Utilities
The setting of the Varying-length-request option affects the setting of the following:
  • Logon-pointer
  • Logon-length
  • Mechanism-data-ptr
  • Mechanism-data-length
  • Run-pointer
  • Run-length
  • Request-pointer
  • Request-length
  • Session-desc-pointer
  • Session-desc-length
  • USING-data-pointer
  • USING-data-length
  • Workload-pointer
  • Workload-length
Setting Result
N The xxxx_pointer contains the starting address of the actual logon string, run string, Teradata SQL request, or using data.

The xxxx_length is set to the length of the corresponding data.

Y The xxxx_pointer contains the address of a two-byte length, which must immediately precede the actual text or data.

The length provided measures only the length of the text or data and does not include the two bytes of its own length. The xxxx_length field is ignored.

If the Maximum-parcel option is set to H, then the two-byte length is considered to be an unsigned value. Because PL/I does not support unsigned integers, you cannot use the Varying-length-request option to allow the PL/I VARYING attribute for the Request-pointer or the USING-data-pointer for requests greater than 32767.

Since the maximum value that can be contained in the two-byte length is 65535, larger lengths cannot use Varying-length-request.