RecordLength (Dataset property): Difference between revisions
Jump to navigation
Jump to search
m (1 revision) |
mNo edit summary |
||
| Line 9: | Line 9: | ||
===Syntax terms=== | ===Syntax terms=== | ||
<table class="syntaxTable"> | <table class="syntaxTable"> | ||
<tr><th>% | <tr><th>%currentNumber</th> | ||
<td>A variable to receive the record length of the dataset | <td>A variable to receive the record length of the <var class="term>dataset</var> object. | ||
</td></tr> | </td></tr> | ||
<tr><th> | <tr><th>dataset</th> | ||
<td>A reference to an instance of a <var>Dataset</var> object. | <td>A reference to an instance of a <var>Dataset</var> object. | ||
</td></tr> | |||
<tr><th>newNumber</th> | |||
<td>A variable to be used to set the <var class="term>dataset</var> object's record length. | |||
</td></tr></table> | </td></tr></table> | ||
==Usage notes== | ==Usage notes== | ||
<ul> | <ul> | ||
Revision as of 22:30, 20 May 2011
The record length of this dataset (Dataset class)
This numeric property indicates the record length (LRECL) for the dataset.
It is only settable while the object is in the Closed state.
An attempt to set it while the dataset is not closed results in request
cancellation.
Syntax
%currentNumber = dataset:RecordLength dataset:RecordLength = newNumber
Syntax terms
| %currentNumber | A variable to receive the record length of the dataset object. |
|---|---|
| dataset | A reference to an instance of a Dataset object. |
| newNumber | A variable to be used to set the dataset object's record length. |
Usage notes
- RecordLength can be set to any value from 1 to 32767.
- The RecordLength default value is 0. However, if RecordLength is not set for a dataset before it is opened, the open process will attempt to determine an appropriate record length for the dataset.
- For input datasets, the record length will usually be set from the input file attributes, whether or not the RecordLength property had been set.
- After an Open, RecordLength reflects the true record length used for the dataset.