FISTAT parameter: Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
(added FISTAT=0 table entry)
 
(10 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 9: Line 10:
==Description==
==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>file is in deferred update mode.</td></tr>
 
<tr><th align="right"><var> X'10'</var></th><td>file has been recovered.</td></tr>
<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> <var>Never reset</var> the FISTAT parameter if the file is physically inconsistent.</p>
<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&nbsp;204</var> releases. You cannot use the RESET command to set undefined bits. If an application makes use of any of the undefined bits of the FISTAT parameter, it might produce unexpected results. </p>
<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&nbsp;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:

SettingMeaning
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.