15.10 - Run 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

Run Length is a four byte field that specifies the length in bytes of the run string for existing applications that set Connect Type to R (the HSHSPB default).

 

In this language...

The variable name for Run Length is...

COBOL

DBCAREA‑RUN‑LEN

PL/I

RUN_LEN

C

run_len

IBM Assembler

DBCNIRSL

 

This routine...

Does this for Run Length...

DBCHINI

writes

DBCHCL

reads (CON)

 

Run Length is used by...

To...

applications

write

The value of Run Length must be positive.

 

If Connect Type is set to...

Then...

C

the maximum value is 24

R

the maximum value after reduction for any leading blanks is 16

 

If Run Pointer is ...

Then...

0

DBCHCL uses the default value of 7 for Run Length.

anything else

the Connect function, before calling DBHCL.

The application does the following, depending on the setting:

  • Y - the Run Length field is ignored. The Run Pointer must point to the two-byte area containing the length of the run string, which is then followed by the actual run string.
  • N - the application must supply the length information in Run Length. See “Variable Length Request” on page 197.
  • If the Connect Type is set to ‘C‘, a connect parcel will be built based on the value set in Run Length.

     

    If the value for Run Length is...

    Then...

    16 or less

    the LSN and Function fields in the connect parcel are set to zero, and run string in the connect parcel is left-justified (in 16 bytes) and spaced‑filled to the right.

    17 to 24

    the value Run Pointer points to is moved into a connect parcel, left-justified and zero‑filled to the right.