NumberOfBuffers (Dataset property): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
mNo edit summary
Line 10: Line 10:
===Syntax terms===
===Syntax terms===
<table class="syntaxTable">
<table class="syntaxTable">
<tr><th>%numbuf</th>
<tr><th>%currentNumber</th>
<td>A variable to receive the number of buffers for the <var>Dataset</var> or
<td>A variable to receive the number of buffers for the <var class="term">dataset</var> object.
to be used to set the <var>Dataset</var>'s number of buffers.
</td></tr>
</td></tr>
<tr><th>%dataset</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 thenumber of buffers for the <var class="term">dataset</var> object.
</td></tr></table>
</td></tr></table>
==Usage notes==
==Usage notes==
<ul>
<ul>

Revision as of 22:00, 20 May 2011

Number of buffers to use for i/o (Dataset class)


This property indicates the number of in-core buffers to be used to hold input or output blocks 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:NumberOfBuffers dataset:NumberOfBuffers = newNumber

Syntax terms

%currentNumber A variable to receive the number of buffers for the dataset object.
dataset A reference to an instance of a Dataset object.
%newNumber A variable to be used to set thenumber of buffers for the dataset object.

Usage notes

  • The default for NumberOfBuffers is 1. This causes all block reads from or writes to the dataset to be synchronous on a thread level.
  • NumberOfBuffers must be a value between 1 and 255, inclusive.
  • If NumberOfBuffers is set to a value greater than 99 on a system that does not support 31-bit BSAM, it is silently set down to 99.
  • The buffers for a dataset are allocated in virtual storage. The amount of virtual storage used for the buffers is the dataset's BlockSize in bytes times its NumberOfBuffers.

See also