Open (Dataset function): Difference between revisions
Jump to navigation
Jump to search
m (→Syntax terms) |
m (→Syntax terms) |
||
| Line 9: | Line 9: | ||
<td>A variable to receive the return code from the <var>Open</var> method, indicating whether or not the open succeeded. | <td>A variable to receive the return code from the <var>Open</var> method, indicating whether or not the open succeeded. | ||
Possible return codes are: | Possible return codes are: | ||
<table> | <table class="nested"> | ||
<tr><th>0</th> | <tr><th>0</th> | ||
<td>Open is successful.</td></tr> | <td>Open is successful.</td></tr> | ||
Revision as of 22:30, 14 November 2012
Open this dataset (Dataset class)
This function opens the dataset associated with a Dataset object.
Syntax
[%rc =] dataset:Open
Syntax terms
| %rc | A variable to receive the return code from the Open method, indicating whether or not the open succeeded.
Possible return codes are:
| ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| dataset | A variable containing a reference to a Dataset object for which the underlying dataset is to be opened. |
Usage notes
- An Open can modify the BlockSize, RecordLength, RecordFormat, or NumberOfBuffers properties. This is especially likely for input datasets where the dataset attributes from the DSCB (or CMS or VSE equivalents) will tend to override attributes set explicitly before the open.
- An Open of a dataset or stream usually places an exclusive lock on the dataset or stream until it is closed. This means no other thread can access the dataset while it is opened.