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