NumberOfBuffers (Dataset property)

From m204wiki
Revision as of 18:03, 20 May 2011 by JAL2 (talk | contribs)
Jump to navigation Jump to search

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.

See also