15.10 - Fetch Maximum Data Length - Call-Level Interface Version 2

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

prodname
Call-Level Interface Version 2
vrm_release
15.10
category
Programming Reference
featnum
B035-2417-035K

Fetch Maximum Data Length is a four byte field that specifies the length in bytes of the move area, if any, allocated by the application.

 

In this language...

The variable name for Fetch Maximum Data Length is...

COBOL

DBCAREA‑FET‑MAX‑DATA‑LEN

PL/I

FET_MAX_DATA_LEN

C

fet_max_data_len

IBM Assembler

DBFIFDL

 

This routine...

Does this for Fetch Maximum Data Length...

DBCHINI

writes

DBCHCL

reads (FET)

 

Fetch Maximum Data Length is used by...

To...

applications

write

Review the following conditions before calling DBCHCL for any of the following functions:

  • Connect
  • RunStartUp
  • Initiate with Protocol‑Function
  • Command
  • Initiate Request
  • If an application is using Move Mode for processing the parcels in the response (that is, Locate Mode is set to N and Parcel Mode Fetch is set to Y in the DBCAREA), then the application must allocate the move area and place its length in Fetch Maximum Data Length.

     

    If Maximum Data Length is set to...

    Then the largest parcel body is...

    O

    32763

    H

    2,147,483,639

    Whether Variable Length Fetch is set to N or Y, the length of the move area must be large enough for the largest parcel body. If Variable Length Fetch is set to Y, two more bytes are required for the preceding length field.