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. |