View source for Resetting file parameters with FILEMGMT

<p>
You use the Reset screens to change the values of <var class="product">Model&nbsp;204</var> file parameters that you originally set on the File Definition screens or the [[Managing file and table size with FILEMGMT#Sizing a new file|File Size Definition screen]]. FILEMGMT stages the file for a <var>RESET</var> command in response to your input.</p>
<p>
The Reset screens display the file parameters that can be reset. File parameters not displayed on the Reset screens can be changed only by recreating the file.</p>

==Resetting file parameters==
<p>
Select the File Maintenance <b>RESET</b> function (number 2) from the primary screen. FILEMGMT displays the File Parameter Reset screen, the first of the two Reset screens: </p>
<p class="caption" style="margin-right:18em">File Parameter Reset screen</p>

<table style="margin-left:2em">
<tr><td>
<p class="code">FILEMGMT                 File Parameter Reset Screen      Page 1 of 2

Filename: METADATA     FICREATE: 7.1  LANGUAGE: US        Inactive
FILE MODEL OPTIONS                                       FILEMODL X' 00 '
  None:X    1nf:_    Numeric Validation:_

TABLE B AND D AND X AUTOMATIC INCREASE OPTIONS:
Table B Auto Increase: Pages: __
Table D Auto Increase: Pages: __
Table X Auto Increase: Pages: __

BRSV: 200    DRSV: 15 % DPGSRES: 2      XRSV:      BREUSE:

FILE OPTIONS:                                            FOPT     X' 00 '
  Disable Lock Pending Updates: _  Only FM Defines New Fields:     _
  No Procedure Statement Labels:_  No Procedure Statement Numbers: _
  Enable Date Time Stamp:       N

FILE RECOVERY OPTIONS                                    FRCVOPT  X' 00 '
  Disable Transaction Backout:  _  No Rollforward (RF):            _
  No RF Logging:                _  No Checkpoint (CK) Logging:     _
  No Updates Without RF Logging:_  No Updates Without CK Logging:  _
  All Updates Applied During RF:_  No Discontinuities Allowed:     _

<b></b>===>                                                                 

1=HELp   2=         3=QUIt     4=FIELDs  5=             6=COMmands
7=       8=FORward  9=        10=       11=ATTributes  12=END
</p></td>
</tr>
</table>
<br>
<p>
You can press F8 (FORward) to display the File Security Reset screen:</p>
<p class="caption" style="margin-right:18em">File Security Reset screen </p>
<table style="margin-left:2em">
<tr><td>
<p class="code">FILEMGMT                  File Security Reset Screen        Page 2 of 2

 Filename: ABC                                                 Inactive
 
 FILE ACCESS                                               OPENCTL X' 80 '
   Public:          X     Semipublic:  _  Private:  _    Record Security:

 REMOTE FILE ACCESS PRIVILEGES
   NO/INV PWD: _   VALID PWD: _  GROUP MEMBER: _

 DEFAULT FILE PRIVILEGES                                   PRIVDEF X' BFFF '
   File Manager:    X     Record Security Override: _   View File Parms: X
  RETRIEVE DATA WITH PROCEDURES
     Adhoc:         X     Internal: X   External:   X
  UPDATE DATA WITH PROCEDURES
     Adhoc:         X     Internal: X   External:   X
  INTERNAL PROCEDURES
     Display/Copy:  X     Define:   X   Change:     X   Delete: X   Include: X

 DEFAULT FIELD LEVEL SECURITY
     SELLVL:        0     READLVL:  0   UPDTLVL:    0   ADDLVL: 0

 DEFAULT PROCEDURE CLASS                PRCLDEF:    0
 
===>

 1=HELp       2=           3=QUIt       4=           5=           6=COMmands
 7=BACkward   8=           9=          10=          11=          12=END
</p></td>
</tr>
</table>

<p>
For some of the file parameters shown on the Reset screens, you specify an actual parameter value. For others, you select options, and FILEMGMT uses your selections to compute appropriate values for the <var>[[FOPT parameter|FOPT]]</var>, <var>[[FRCVOPT parameter|FRCVOPT]]</var>, <var>[[OPENCTL parameter|OPENCTL]]</var>, and <var>[[PRIVDEV parameter|PRIVDEF]]</var> parameters.</p>
<p>
You need not fill in all values on all screens. Current parameter values are preserved for any parameters for which you do not enter values.</p>
<p>
You can move freely between the two Reset screens by pressing the F7 (BACkward) and F8 (FORward) keys. FILEMGMT does not save any of the information you enter until you press one of the following function keys from either of the screens:</p>
<table>
<tr>
<td>F6 </td>
<td>COMmands</td>
</tr>

<tr>
<td>F12</td>
<td>END </td>
</tr>
</table>
<p>
The [[#Input for the File Parameter Reset screen|Input for the File Parameter Reset screen]] section describes the type of information you enter. </p>
<ul>
<li>For more information about parameter settings, select the parameter you want from the [[List of Model 204 parameters|list of Model 204 parameters]].</li>

<li>For a discussion about how to select the most appropriate options for your particular file, refer to [[File design]].</li>
</ul>
<p>
The cursor is initially positioned at the first input prompt on the first screen.</p>

===Input for the File Parameter Reset screen===
<p>
You can select more than one option from an option category.</p>
<p>
To select an option, type <code>X</code> or a numeric value.</p>
<p>
To enter a null: type a space, or preserve the adjacent default underscore character (<tt>_</tt>). Null indicates that you do not want to select the option. </p>
<p>
Typing a character other than these is invalid, and produces an error message.</p>
<p>
FILEMGMT displays and/or prompts you for the following information:</p>
<table class="thJustBold">
<tr class="head">
<th>Prompt</th>
<th>Response</th>
</tr>

<tr>
<th>Filename</th>
<td>FILEMGMT displays the name of the file that you entered on the [[Logging on to FILEMGMT#FILEMGMT primary screen|primary screen]], and indicates whether the file is <b>Active</b> or <b>Inactive</b>. </td>
</tr>

<tr>
<th>FICREATE</th>
<td><var class="product">Model&nbsp;204</var> version number for the file you are creating. FILEMGMT uses this value to calculate the file size and validate certain <var class="product">Model&nbsp;204</var> file features. </td>
</tr>

<tr>
<th>RDFS</th>
<td>Reuse direct file space file. Prompted when the file is an RDFS file (that is, entry-order reuse record numbers). </td>
</tr>

<tr>
<th>Reuse First</th>
<td>For an RDFS file only. Record numbers are reused whenever possible by records as they are added. </td>
</tr>

<tr>
<th>Append First</th>
<td>For an RDFS file only. Record numbers are reused only when no remaining space is at the end of the table. </td>
</tr>

<tr>
<th>FILE MODEL OPTIONS</th>
<td>For more information about these, see [[Field attributes#File model feature|File model feature]] and [[FILEMODL parameter]].</td>
</tr>

<tr>
<th>TableB Auto Increase Pages</th>
<td>If you want <var class="product">Model&nbsp;204</var> to automatically increase Table B when it becomes full, enter the number of pages to add. The parameter <var>[[BAUTOINC parameter|BAUTOINC]]</var> is set to your specified value.</td>
</tr>

<tr>
<th>TableD Auto Increase Pages</th>
<td>If you want <var class="product">Model&nbsp;204</var> to automatically increase Table D when it becomes full, enter the number of pages to add.</td>
</tr>

<tr>
<th>TableX Auto Increase Pages</th>
<td>If you want <var class="product">Model&nbsp;204</var> to automatically increase Table X when it becomes full, enter the number of pages to add.</td>
</tr>


<tr>
<th>BRSV</th>
<td>Specify <var>[[BRESERVE parameter|BRESERVE]]</var>, the number of bytes reserved for expansion on Table B pages. The maximum value is the value of <code>PAGESZ-40</code>. The default is 17. </td>
</tr>

<tr>
<th>DRSV</th>
<td>Specify <var>[[DRESERVE parameter|DRESERVE]]</var>, the percentage of space in a Table D page reserved for expansion. <var>DRESERVE</var> applies only to inversion pages. Valid values are 0-100. The default is 15. </td>
</tr>

<tr>
<th>DPGSRES</th>
<td>Specify <var>[[DPGSRES parameter|DPGSRES]]</var>, the number of pages in Table D held in reserve. The file is marked full when the first of the <var>DPGSRES</var> pages is used, but transaction backout processing is allowed to continue. 
<p>
Valid values are 1-32767. <b>DPGSRES</b> must be less than the value of <var>[[DSIZE parameter|DSIZE]]</var>. The default is <code>DSIZE/50 + 2</code>; if <code>DSIZE/50 + 2</code> is greater than 40, the default is 40.</p>
</td>
</tr>

<tr>
<th>XRSV</th>
<td>Specify <var>[[XRESERVE parameter|XRESERVE]]</var>, the number of bytes of space in a Table X page reserved for expansion. Valid values are 0-6140. The default is 17. </td>
</tr>

<tr>
<th>BREUSE</th>
<td>For an unordered file only. Specified as a percentage of space on a page; it determines which pages can hold another record. To be reused for storing another record, the page must have the following minimum number of bytes of free space: 
<p class="code">(<i>usable_page_size</i> - BRESERVE)*BREUSE + BRESERVE
</p>
<p>
<var class="term">usable_page_size</var> is the size of the page minus overhead. The default is 20. </p>
</td>
</tr>

<tr>
<th>FILE OPTIONS</th>
<td>Select file characteristics for the specified file. FILEMGMT computes the new value of the <var class="product">Model&nbsp;204</var> <var>FOPT</var> parameter from your selections, and it displays the computed value.</td>
</tr>

<tr>
<th>Disable Lock Pending Updates</th>
<td>Lock pending updates feature is disabled. If this option is selected, <b>Disable Transaction Backout</b> must also be selected. The default is null.</td>
</tr>

<tr>
<th>Only FM Defines New Fields </th>
<td>New fields in the <var class="product">Model&nbsp;204</var> file can be defined only by a user with file manager privileges. The default is null.</td>
</tr>

<tr>
<th nowrap>No Procedure Statement Numbers</th>
<td>Statement numbers cannot be assigned to procedure lines. The default is null.</td>
</tr>

<tr>
<th>No Procedure Statement Labels </th>
<td>Statement labels cannot be assigned to procedure lines. The default is null.</td>
</tr>

<tr>
<th>FILE RECOVERY OPTIONS </th>
<td>Select file recovery characteristics for the specified file. FILEMGMT computes a new value for the <var class="product">Model&nbsp;204</var> <var>FRCVOPT</var> parameter from your selections and displays the computed value.</td>
</tr>

<tr>
<th>Disable Transaction Backout</th>
<td>File does not use the <var class="product">Model&nbsp;204</var> transaction backout feature. This option is required if <b>Disable Lock Pending Updates</b> is selected. The default is null.</td>
</tr>

<tr>
<th>No Rollforward (RF)</th>
<td>File does not use the roll forward facility of the <var>[[RESTART command|RESTART]]</var> command. The default is null.</td>
</tr>

<tr>
<th>No RF Logging</th>
<td><var class="product">Model&nbsp;204</var> does not log changes to the journal file. The default is null.</td>
</tr>

<tr>
<th>No Checkpoint (CK) Logging</th>
<td><var class="product">Model&nbsp;204</var> does not log checkpoint information to the checkpoint data set. The default is null.</td>
</tr>

<tr>
<th>No Updates Without RF Logging</th>
<td>File is not updated unless roll forward logging is active. The default is null.</td>
</tr>

<tr>
<th>No Updates Without CK Logging</th>
<td>File is not updated unless checkpoint logging is active. The default is null.</td>
</tr>

<tr>
<th>All Updates Applied During RF </th>
<td>All updates to the file are applied when the file is rolled forward. The default is null.</td>
</tr>

<tr>
<th>No Discontinuities Allowed </th>
<td>Only updates that do not result in discontinuities are applied to the file. The default is null.</td>
</tr>
</table>


[[Category:FILEMGMT application subsystem]]