BlockSize (Dataset property): Difference between revisions
Jump to navigation
Jump to search
mNo edit summary |
mNo edit summary |
||
| Line 1: | Line 1: | ||
{{Template:Dataset:BlockSize subtitle}} | |||
This numeric property indicates the block size for the dataset. | This numeric property indicates the block size for the dataset. | ||
| Line 4: | Line 5: | ||
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:BlockSize syntax}} | |||
===Syntax terms=== | ===Syntax terms=== | ||
<table class="syntaxTable"> | <table class="syntaxTable"> | ||
| Line 19: | Line 17: | ||
</td></tr></table> | </td></tr></table> | ||
==Usage | ==Usage notes== | ||
<ul> | <ul> | ||
<li><var>Blocksize</var> can be set to any value from 1 to 32767. | <li><var>Blocksize</var> can be set to any value from 1 to 32767. | ||
| Line 28: | Line 26: | ||
file attributes, whether or not the <var>Blocksize</var> property had been set. | file attributes, whether or not the <var>Blocksize</var> property had been set. | ||
</ul> | </ul> | ||
==See also== | |||
{{Template:Dataset:BlockSize footer}} | |||
Revision as of 18:03, 20 May 2011
The block size of this dataset (Dataset class)
This numeric property indicates the block size 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:BlockSize dataset:BlockSize = newNumber
Syntax terms
| %blksz | A variable to receive the blocksize of the dataset or
to be used to set the dataset's blocksize. |
|---|---|
| %dataset | A reference to an instance of a Dataset object. |
Usage notes
- Blocksize can be set to any value from 1 to 32767.
- If Blocksize is never set for a dataset before it is opened, the open process will attempt to determine an appropriate blocksize for the dataset.
- For input datasets, the blocksize will usually be set from the input file attributes, whether or not the Blocksize property had been set.