Run Length
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: |
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. |