NumberOfBuffers (Dataset property): Difference between revisions
Jump to navigation
Jump to search
mNo edit summary |
mNo edit summary |
||
| Line 1: | Line 1: | ||
{{Template:Dataset:NumberOfBuffers subtitle}} | |||
This property indicates the number of in-core buffers to be used to hold | This property indicates the number of in-core buffers to be used to hold | ||
input or output blocks for the <var>Dataset</var>. | input or output blocks for the <var>Dataset</var>. | ||
| 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. | ||
== | ==Syntax== | ||
{{Template:Dataset:NumberOfBuffers syntax}} | |||
===Syntax terms=== | ===Syntax terms=== | ||
<table class="syntaxTable"> | <table class="syntaxTable"> | ||
| Line 19: | Line 18: | ||
</td></tr></table> | </td></tr></table> | ||
==Usage | ==Usage notes== | ||
<ul> | <ul> | ||
<li>The default for <var>NumberOfBuffers</var> is 1. | <li>The default for <var>NumberOfBuffers</var> is 1. | ||
| Line 31: | Line 30: | ||
<var>[[BlockSize (Dataset property)|BlockSize]]</var> in bytes times its <var>NumberOfBuffers</var>. | <var>[[BlockSize (Dataset property)|BlockSize]]</var> in bytes times its <var>NumberOfBuffers</var>. | ||
</ul> | </ul> | ||
==See also== | |||
{{Template:Dataset:NumberOfBuffers footer}} | |||
Revision as of 18:03, 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
| %numbuf | A variable to receive the number of buffers for the Dataset or
to be used to set the Dataset's number of buffers. |
|---|---|
| %dataset | A reference to an instance of a 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.