RecordLength (Dataset property)

From m204wiki
Revision as of 16:51, 20 May 2011 by JAL2 (talk | contribs) (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 ...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

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.

RecordLength syntax

%recln = %dataset:RecordLength %dataset:RecordLength = %recln

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.