Variable Length Request - Call-Level Interface Version 2

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

Product
Call-Level Interface Version 2
Release Number
15.00
Language
English (United States)
Last Update
2018-09-25
dita:id
B035-2418
lifecycle
previous
Product Category
Teradata Tools and Utilities

Variable Length Request

Usage Notes

The Variable Length Request field specifies the location of the length information for the request.

 

Language

Variable Name

COBOL:

DBCAREA-VAR-LEN-REQ

C: DBCAREA.H:

var_len_req

 

Routine

Action Taken

DBCHINI:

writes

DBCHCL:

reads (CON; RSUP: IRQ)

 

Used by

Action Taken

application program

writes

Variable Length Request is initialized by DBCHINI to the default value provided for Variable Length Request in the site’s SPB.

If the value provided is not appropriate for the application, before calling DBCHCL for the Connect, Run Startup, or Initiate Request function, the application program may set:

  • Change Options to Y, and
  • Variable Length Request to:
  • Y, if the length information is to immediately precede the string to which it applies.
  • N, if the length information is to be supplied separately from the string to which it applies.
  • 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 N, the address supplied in Request Pointer points to the beginning of the text of the request, and the length of the request text is supplied in a separate field of the DBCAREA, Request Length.
  • If Variable Length Request is set to Y, the address supplied in Request Pointer points to a two-byte length (in binary) field which precedes the text of the request, and 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.
  • 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.

    Note: 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 order shown above. In all cases, the pointer to the string must contain the address of the first fragment that is supplied.