RecordLength (Dataset property)

From m204wiki
Jump to: navigation, search

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.

See also