NumberOfBuffers (Dataset property)
NumberOfBuffers (Dataset property)
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.
NumberOfBuffers syntax
%numbuf = %dataset:NumberofBuffers %dataset:NumberOfBuffers = %numbuf
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.