RecordFormat (Dataset property): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (Created page with "This <var>RecordFormat</var> enumeration property indicates the physical record format of the input or output blocks. It is only settable while the object is in the <var>Closed</...")
 
m (Created page with "This <var>RecordFormat</var> enumeration property indicates the physical record format of the input or output blocks. It is only settable while the object is in the <var>Closed</...")
Line 1: Line 1:
{{Template:Dataset:RecordFormat subtitle}}
This <var>RecordFormat</var> enumeration property indicates the physical record format
This <var>RecordFormat</var> enumeration property indicates the physical record format
of the input or output blocks.
of the input or output blocks.
Line 4: Line 6:
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.
==RecordFormat syntax==
==Syntax==
<p class="pre"> %recfm = %dataset:recordFormat
{{Template:Dataset:RecordFormat syntax}}
%dataset:recfm = %recfm
</p>
===Syntax terms===
===Syntax terms===
<table class="syntaxTable">
<table class="syntaxTable">
Line 19: Line 18:
   
   
</td></tr></table>
</td></tr></table>
==Usage Notes==
==Usage notes==
<ul>
<ul>
<li><var>RecordFormat</var> is a bit of a misnomer in that it describes both the
<li><var>RecordFormat</var> is a bit of a misnomer in that it describes both the
Line 29: Line 28:
file attributes, whether or not the <var>RecordFormat</var> property had been set.
file attributes, whether or not the <var>RecordFormat</var> property had been set.
</ul>
</ul>
==See also==
{{Template:Dataset:RecordFormat footer}}

Revision as of 18:03, 20 May 2011

The format of record i/o blocks (Dataset class)


This RecordFormat enumeration property indicates the physical record format of the input or output blocks. 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

%currentRecordFormat = dataset:RecordFormat dataset:RecordFormat = newRecordFormat

Syntax terms

%recfm A RecordFormat enumeration variable to receive the value indicating

the dataset record format or to be used to set the dataset's record format.

%dataset A reference to an instance of a Dataset object.

Usage notes

  • RecordFormat is a bit of a misnomer in that it describes both the block and the record format.
  • If RecordFormat is never set for a dataset before it is opened, the open process will attempt to determine an appropriate record format for the dataset.
  • For input datasets, the record format will usually be set from the input file attributes, whether or not the RecordFormat property had been set.

See also