Changing the Value for Variable Length Request|CLIv2 - Changing the Value for Variable Length Request - 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
Language
English (United States)
Last Update
2024-05-14
dita:mapPath
bmn1691484839905.ditamap
dita:ditavalPath
obe1474387269547.ditaval
dita:id
fvz1470444150352
Product Category
Teradata Tools and Utilities

If the value provided is not appropriate for the application, perform the following steps before calling DBCHCL for the Connect, Run Startup, or Initiate Request function:

  1. Set Change-options to 'Y'.
  2. Change the value for Variable Length Request as follows.
    If the length information is to... Then change the value for Variable Length Request to...
    precede immediately the data to which it applies Y
    be supplied separately from the data to which it applies N

    For example, to do a request, the application program must supply to DBCHCL both the length and the address of the request.

    If Variable Length Request is set to this value... Then the address supplied in the appropriate pointer field points to...
    Y a two-byte (in binary) area that precedes the text of the request.

    The length of the request text is not supplied in Request Length.

    The length provided preceding the text measures only the length of the request text, and does not include the two bytes of its own length.

    N the beginning of the text of the request.

    The length of the request text is supplied in the appropriate DBCAREA, Request Length field.

The Variable Length Request setting affects only the request string. The logon string, run string, and input data string always have the length supplied separately from the string.

The fragments of the string must be in the following order, if applicable:
two-byte length information

   followed by n-byte indicator information

      followed by bytes containing the
         text or value information

In situations in which only two fragments apply, they must be in the same order shown here. In all cases, the pointer to the string must contain the address of the first fragment that is supplied.