16.20 - Run-length - Teradata Tools and Utilities

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

prodname
Teradata Tools and Utilities
vrm_release
16.20
created_date
September 2019
category
Programming Reference
featnum
B035-2417-108K

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, 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 Varying-length-request.

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.