Mechanism-data-len - Call-Level Interface Version 2

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

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

Mechanism‑data‑len

If additional data is required by the specified Mechanism‑name, Mechanism‑data‑length specifies the length, in bytes, of the area addressed by Logon‑mechanism‑data‑pointer. If a Mechanism‑name is not specified, the value will be ignored.

Mechanism‑data‑len exists only when DBCHINI had been called for a DBCAREA with Total‑length set to at least 640 (that is, the returned DBCAREA Level value is at least 1). For a smaller DBCAREA, Mechanism‑data‑len is ignored.

Note: Logon mechanisms are currently not supported for a mainframe‑connected system.

 

In this language...

The variable name for Mechanism‑data‑length is...

COBOL

MECHANISM‑DATA‑LEN

PL/I

MECHANISM_DATA_LEN

C

mechanismDataLen

IBM Assembler

DBCNIMDL

 

This routine...

Does this for Mechanism‑data‑length...

DBCHINI

writes

DBCHCL

reads (CON)

 

Mechanism‑data‑length is used by...

To...

applications

write

The value must be positive with a maximum value of:

  • 32763 if the Maximum‑parcel option is set to O, or
  • 65531 if the Maximum‑parcel option is set to H.
  • This field is ignored if Variable‑length‑request is set to Y, in which case Logon‑mechanism‑data‑pointer addresses a two‑byte area containing the length of the data, followed by the data itself.