FISTAT parameter: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
(added FISTAT=0 table entry) |
||
| (11 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
{{Template:FISTAT parameter subtitle}} | |||
<dl> | <dl> | ||
<dt>Class<dd>FPARMS | <dt>Class<dd>FPARMS | ||
| Line 6: | Line 7: | ||
<dd>The current status of the file | <dd>The current status of the file | ||
</dl> | </dl> | ||
==Description== | |||
<p> | <p> | ||
Valid settings of FISTAT (options can be summed) are: </p> | Valid settings of <var>FISTAT</var> (options can be summed) are: </p> | ||
<table> | <table> | ||
<tr><th>Setting</th><th>Meaning</th></tr> | <tr class="head"><th>Setting</th><th>Meaning</th></tr> | ||
<tr><th align="right"><var>X'40'</var></th><td>File might be logically inconsistent.</td></tr> | <tr><th align="right"><var>X'40'</var></th><td>File might be logically inconsistent.</td></tr> | ||
<tr><th align="right"><var> X'20'</var></th><td> | |||
<tr><th align="right"><var> X'10'</var></th><td> | <tr><th align="right"><var> X'20'</var></th> | ||
<tr><th align="right"><var> X'08'</var></th><td>File is full.</td></tr> | <td>File is in [[Deferred update feature|deferred update]] mode.</td></tr> | ||
<tr><th align="right"><var> X'02'</var></th><td>File is physically inconsistent. | |||
<p class="note"><b>Note:</b> < | <tr><th align="right"><var> X'10'</var></th> | ||
<td>File has been recovered.</td></tr> | |||
<tr><th align="right"><var> X'08'</var></th> | |||
<td>File is full.</td></tr> | |||
<tr><th align="right"><var> X'02'</var></th> | |||
<td>File is physically inconsistent. | |||
<p class="note"><b>Note:</b> <b><i>Never</i></b> reset <var>FISTAT</var> if the file is physically inconsistent.</p> | |||
</td></tr> | </td></tr> | ||
<tr><th align="right"><var> X'01'</var></th><td>File is not initialized. </td></tr> | |||
<tr><th align="right"><var> X'01'</var></th> | |||
<td>File is not [[INITIALIZE command|initialized]]. </td></tr> | |||
<tr><th align="right"><var> X'00'</var></th> | |||
<td>File is logically and physically consistent. </td></tr> | |||
</table> | </table> | ||
<p class="note"><b>Note:</b> When a file is opened, bits that are not currently defined by Rocket Software for FISTAT are reset. This bit resetting is designed to set aside these bits for features of future <var class="product">Model 204</var> releases. You cannot use the RESET command to set undefined bits | <p class="note"><b>Note:</b> When a file is opened, bits that are not currently defined by Rocket Software for <var>FISTAT</var> are reset. This bit resetting is designed to set aside these bits for features of future <var class="product">Model 204</var> releases. You cannot use the <var>[[RESET command|RESET]]</var> command to set undefined bits, as if an application was to make use of any of the undefined bits of the <var>FISTAT</var> parameter, it might produce unexpected results. </p> | ||
<p>As of Model 204 version 7.5, <var>FISTAT</var> X'08' is automatically cleared in a [[Transaction back out|TBO]] file if [[Table D (File architecture)|Table D]] is increased enough so that <var>[[DSIZE parameter|DSIZE]]</var> is greater than or equal to <code>[[DPGSRES parameter|DPGSRES]]+[[DPGSUSED parameter|DPGSUSED]]</code>.</p> | |||
[[Category:Parameters]] | [[Category:Parameters]] | ||
Latest revision as of 22:27, 2 July 2018
Current status of file
- Class
- FPARMS
- Setting
- By Model 204 or reset by file manager
- Meaning
- The current status of the file
Description
Valid settings of FISTAT (options can be summed) are:
| Setting | Meaning |
|---|---|
| X'40' | File might be logically inconsistent. |
| X'20' | File is in deferred update mode. |
| X'10' | File has been recovered. |
| X'08' | File is full. |
| X'02' | File is physically inconsistent.
Note: Never reset FISTAT if the file is physically inconsistent. |
| X'01' | File is not initialized. |
| X'00' | File is logically and physically consistent. |
Note: When a file is opened, bits that are not currently defined by Rocket Software for FISTAT are reset. This bit resetting is designed to set aside these bits for features of future Model 204 releases. You cannot use the RESET command to set undefined bits, as if an application was to make use of any of the undefined bits of the FISTAT parameter, it might produce unexpected results.
As of Model 204 version 7.5, FISTAT X'08' is automatically cleared in a TBO file if Table D is increased enough so that DSIZE is greater than or equal to DPGSRES+DPGSUSED.