RecordLength (Dataset property): Difference between revisions
Jump to navigation
Jump to search
m (Created page with "This numeric property indicates the record length (LRECL) for the dataset. It is only settable while the object is in the <var>Closed</var> state. An attempt to set it while the ...") |
m (Created page with "This numeric property indicates the record length (LRECL) for the dataset. It is only settable while the object is in the <var>Closed</var> state. An attempt to set it while the ...") |
||
| Line 1: | Line 1: | ||
{{Template:Dataset:RecordLength subtitle}} | |||
This numeric property indicates the record length (LRECL) for the dataset. | This numeric property indicates the record length (LRECL) for the dataset. | ||
It is only settable while the object is in the <var>Closed</var> state. | It is only settable while the object is in the <var>Closed</var> state. | ||
An attempt to set it while the dataset is not closed results in request | An attempt to set it while the dataset is not closed results in request | ||
cancellation. | cancellation. | ||
== | ==Syntax== | ||
{{Template:Dataset:RecordLength syntax}} | |||
===Syntax terms=== | ===Syntax terms=== | ||
<table class="syntaxTable"> | <table class="syntaxTable"> | ||
| Line 18: | Line 17: | ||
</td></tr></table> | </td></tr></table> | ||
==Usage | ==Usage notes== | ||
<ul> | <ul> | ||
<li><var>RecordLength</var> can be set to any value from 1 to 32767. | <li><var>RecordLength</var> can be set to any value from 1 to 32767. | ||
| Line 30: | Line 29: | ||
reflects the true record length used for the dataset. | reflects the true record length used for the dataset. | ||
</ul> | </ul> | ||
==See also== | |||
{{Template:Dataset:RecordLength footer}} | |||
Revision as of 18:03, 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
| %recln | A variable to receive the record length of the dataset or
to be used to set the dataset's record length. |
|---|---|
| %dataset | A reference to an instance of a Dataset object. |
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.