Defining file procedures with FILEMGMT: Difference between revisions

From m204wiki
Jump to navigation Jump to search
(Automatically generated page update)
 
(Automatically generated page update)
 
(12 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<p>If your file includes procedures, use the File Definition - Procedure screen to specify the <var class="product">Model&nbsp;204</var> file parameters that describe the procedures stored in the file. </p>
 
<p>This screen is used when creating a file to store procedures. If the file is a data file, just use the defaults on this screen.</p>
<p>
<p>If this is a file for storing procedures, pay close attention to the values used in calculating PDSTRPPG and PDSIZE.[if user underestimates these, procedure dictionary can get filled up and user cannot enter any more procedures into the file]</p>
If your file includes procedures, use the File Definition - Procedure screen to specify the <var class="product">Model&nbsp;204</var> file parameters that describe the procedures stored in the file. </p>
<p>Press the PF8 (FORward) key from the File Definition - Security screen. FILEMGMT displays the third File Definition Screen, the Procedure screen: </p>
<ul>
<li>If the file is a data file, just use the defaults on this screen.</li>
<li>If this is a file for storing procedures, pay close attention to the values used in calculating <var>[[PDSTRPPG parameter|PDSTRPPG]]</var> and <var>[[PDSIZE parameter|PDSIZE]]</var>. If you underestimate these values, the procedure dictionary may fill and prevent the adding of more procedures into the file.</li>
</ul>
 
==File Definition - Procedure screen==
<p>
Press the F8 (FORward) key from the File Definition - Security screen. FILEMGMT displays the third File Definition Screen, the Procedure screen: </p>
<table>
<table>
<tr>
<tr>
Line 33: Line 40:
</tr>
</tr>
</table>
</table>
==Defining procedures in a file==
 
<p>You use the File Definition - Procedure screen to specify the <var class="product">Model&nbsp;204</var> file parameters that describe the procedures stored in the file. </p>
<p>
<p>This screen is used when creating a file to store procedures. </p>
When this screen is displayed for a file for the first time, FILEMGMT shows the standard <var class="product">Model&nbsp;204</var> default values for the parameters.</p>
<p>You can specify values for these fields:</p>
<ul>
<ul>
<li>If the file will store data, simply use the defaults on this screen.</li>
<li><b>NUMBER OF PROCEDURE ENTRIES</b> (<b>Expected</b>)</li>
<li>If the file will store procedures, pay close attention to the values used in calculating PDSTRPPG and PDSIZE. If you underestimate these values, the procedure dictionary could fill up, preventing you from entering any more procedures into the file.</li>
<li><b>AVERAGE PAGES PER PROC</b> (<b>Expected</b>)</li>
<li><b>Avg Procname Length</b></li>
<li><b>PRCLDEF</b>  </li>
</ul>
</ul>
<p>When this screen is displayed for a file for the first time, FILEMGMT shows the standard <var class="product">Model&nbsp;204</var> default values for the parameters.</p>
<p>
<p>You can specify values for:</p>
FILEMGMT uses the field values to calculate the values of <var>PDSTRPPG</var> (maximum procedure entries) and <var>PDSIZE</var> (pages in Table D procedure directory).</p>
<ul>
<p>
<li>NUMBER OF PROCEDURE ENTRIES (Expected)</li>
For a discussion of how to select the most appropriate parameter options for your particular file, refer to [[File size calculation in detail#Sizing the procedure dictionary|Sizing the procedure dictionary]].</p>
<li>AVERAGE PAGES PER PROC (Expected)</li>
<p>
<li>Avg Procname Length</li>
The cursor is initially positioned at the <b>Expected</b> prompt for <b>NUMBER OF PROCEDURE ENTRIES</b>.</p>
<li>PRCLDEF  </li>
 
</ul>
<p>FILEMGMT uses the values of these prompts to calculate the values of PDSTRPPG (maximum procedure entries) and PDSIZE (pages in Table D procedure directory).</p>
<p>For information about parameter settings, refer to the <var class="product">Model&nbsp;204</var> Parameter and Command Reference. For a discussion of how to select the most appropriate options for your particular file, refer to the Rocket <var class="product">Model&nbsp;204</var> File Manager's Guide.</p>
<p>The cursor is initially positioned at the first input prompt (Expected NUMBER OF PROCEDURE ENTRIES).</p>
==Procedure screen input==
==Procedure screen input==
<p>FILEMGMT displays and/or prompts you for the following information.</p>
<p>
<table>
FILEMGMT displays and/or prompts you for the following information:</p>
 
<table class="thJustBold">
<tr class="head">
<tr class="head">
<th>Prompt</th>
<th>Prompt</th>
<th>Response</th>
<th>Response</th>
</tr>
</tr>
<tr>
<tr>
<td>Filename</td>
<th>Filename</th>
<td>FILEMGMT displays the name of the file that you entered on the primary screen, and indicates whether the file is Active or Inactive.</td>
<td>FILEMGMT displays the name of the file that you entered on the primary screen, and indicates whether the file is Active or Inactive.</td>
</tr>
</tr>
<tr>
<th colspan="2">MAXIMUM PROCEDURE ENTRIES/TABLE D DICTIONARY PAGE</th>
</tr>
<tr>
<tr>
<td>MAXIMUM PROCEDURE ENTRIES/TABLE D DICTIONARY PAGE PDSTRPPG </td>
<th>PDSTRPPG </th>
<td>
<td>Displays the maximum number of procedure entries on a directory page. The value is calculated from:  
<p>Displays the maximum number of procedure entries on a directory page. The value is calculated from: </p>
<ul>
<ul>
<li>Number of procedure entries </li>
<li>Number of procedure entries </li>
Line 71: Line 84:
<li>Average procedure name length </li>
<li>Average procedure name length </li>
</ul>
</ul>
<p>The value in this input field is entry-protected Valid values are 1-256. The default is 128 entries.</p>
<p>
</td>
The value in this input field is entry-protected Valid values are 1-256. The default is 128 entries.</p></td></tr>
 
<tr>
<th colspan="2">PAGES IN TABLE D PROCEDURE DICTIONARY</th>
</tr>
</tr>
<tr>
<tr>
<td>PAGES IN TABLE D PROCEDURE DICTIONARY PDSIZE</td>
<th>PDSIZE</th>
<td>
<td>Displays the number of contiguous pages in the procedure directory. PDSIZE must be less than the value of the <var>[[DSIZE parameter|DSIZE]]</var> parameter on the File Size Definition screen. The value is calculated from:
<p>Displays the number of contiguous pages in the procedure directory. PDSIZE must be less than the value of the DSIZE parameter on the File Size Definition screen. The value is calculated from:</p>
<ul>
<ul>
<li>Number of procedure entries </li>
<li>Number of procedure entries </li>
Line 83: Line 99:
<li>Average procedure name length</li>
<li>Average procedure name length</li>
</ul>
</ul>
<p>Valid values are 1-255. The default is 3 pages.</p>
<p>Valid values are 1-255. The default is 3 pages.</p></td></tr>
</td>
 
</tr>
<tr>
<tr>
<td colspan="2">NUMBER OF PROCEDURE ENTRIES</td>
<th colspan="2">NUMBER OF PROCEDURE ENTRIES</th>
</tr>
</tr>
<tr>
<tr>
<td>Current</td>
<th>Current</th>
<td>FILEMGMT displays the number of procedures currently defined in the procedure directory. The value in this input field is entry-protected.</td>
<td>FILEMGMT displays the number of procedures currently defined in the procedure directory. The value in this input field is entry-protected.</td>
</tr>
</tr>
<tr>
<tr>
<td>Expected</td>
<th>Expected</th>
<td>Specify the number of procedures you expect to store in the file. Valid values are 0 through the number of pages allowed in Table D, and null. The default is null. </td>
<td>Specify the number of procedures you expect to store in the file. Valid values are 0 through the number of pages allowed in Table D, and null. The default is null. </td>
</tr>
</tr>
<tr>
<tr>
<td colspan="2">AVERAGE PAGES PER PROC</td>
<th colspan="2">AVERAGE PAGES PER PROC</th>
</tr>
</tr>
<tr>
<tr>
<td>Current</td>
<th>Current</th>
<td>FILEMGMT displays the average number of pages of the procedures currently stored in the file. The value in this input field is entry-protected. The default is 1.</td>
<td>FILEMGMT displays the average number of pages of the procedures currently stored in the file. The value in this input field is entry-protected. The default is 1.</td>
</tr>
</tr>
<tr>
<tr>
<td>Expected</td>
<th>Expected</th>
<td>Specify the average number of pages of the procedures you expect to store in the file. Valid values are 1 through 999999, and null. The default is 1. </td>
<td>Specify the average number of pages of the procedures you expect to store in the file. Valid values are 1 through 999999, and null. The default is 1. </td>
</tr>
</tr>
<tr>
<tr>
<td>Avg Procname Length</td>
<th>Avg Procname Length</th>
<td>Specify the average length of the procedure names stored in the file. Valid values are 1 through 255. The default is 20 characters.</td>
<td>Specify the average length of the procedure names stored in the file. Valid values are 1 through 255. The default is 20 characters.</td>
</tr>
</tr>
<tr>
<tr>
<td>DEFAULT PROCEDURE CLASS PRCLDEF </td>
<th colspan="2">DEFAULT PROCEDURE CLASS</th>
</tr>
 
<tr>
<th>PRCLDEF </th>
<td>Specify the default user class for procedures, if the file is public or semipublic. Valid values are 0 through 255. The default is 0.</td>
<td>Specify the default user class for procedures, if the file is public or semipublic. Valid values are 0 through 255. The default is 0.</td>
</tr>
</tr>
</table>
</table>
==Procedure screen commands==
==Procedure screen commands==
<p>To issue a command, press a PF key or type a command name at the prompt (===>) and press Enter.</p>
<p>
To issue a command, press a PF key or type a command name at the prompt (<b>===></b>) and press Enter.</p>
 
<table>
<table>
<tr class="head">
<tr class="head">
Line 125: Line 154:
<th>Meaning</th>
<th>Meaning</th>
</tr>
</tr>
<tr>
<tr>
<td>PF1</td>
<td>F1</td>
<td>HELp</td>
<td>HELp</td>
<td>Displays HELP text for the File Definition - Procedure screen.</td>
<td>Displays Help text for the File Definition - Procedure screen.</td>
</tr>
</tr>
<tr>
<tr>
<td>PF3</td>
<td>F3</td>
<td>QUIt</td>
<td>QUIt</td>
<td>Exits from the Procedure screen and returns to the primary screen without making any changes. </td>
<td>Exits from the Procedure screen and returns to the primary screen without making any changes. </td>
</tr>
</tr>
<tr>
<tr>
<td>PF4</td>
<td>F4</td>
<td>FIElds</td>
<td>FIElds</td>
<td>Stages the file for CREATE or RECREATE. Proceeds to the Field Name List screen in DEFINE mode. This screen lists the fields in the file you are creating. </td>
<td>Stages the file for <var>CREATE</var> or <var>RECREATE</var>. Proceeds to the [[Defining fields with FILEMGMT|Field Name List screen]] in <var>DEFINE</var> mode. This screen lists the fields in the file you are creating. </td>
</tr>
</tr>
<tr>
<tr>
<td>PF6</td>
<td>F6</td>
<td>COMmands </td>
<td>COMmands </td>
<td>Stages the file for CREATE or RECREATE. Proceeds to the Execute Commands screen. This screen displays the staged commands that were generated for the file and allows you to select the commands you want to execute. </td>
<td>Stages the file for <var>CREATE</var> or <var>RECREATE</var>. Proceeds to the [[Executing and deleting commands with FILEMGMT#Execute Commands screen|Execute Commands screen]]. This screen displays the staged commands that were generated for the file and allows you to select the commands you want to execute. </td>
</tr>
</tr>
<tr>
<tr>
<td>PF7</td>
<td>F7</td>
<td>BACkward</td>
<td>BACkward</td>
<td>Proceeds to the File Definition Security screen. This screen allows you to specify file security parameters for the file you are creating. </td>
<td>Proceeds to the [[Defining file security with FILEMGMT|File Definition - Security screen]]. This screen allows you to specify file security parameters for the file you are creating. </td>
</tr>
</tr>
<tr>
<tr>
<td>PF9</td>
<td>F9</td>
<td>SIZe</td>
<td>SIZe</td>
<td>Stages the file for CREATE or RECREATE. Proceeds to the File Size Definition screen. This screen displays information about the size of the file you are creating.</td>
<td>Stages the file for <var>CREATE</var> or <var>RECREATE</var>. Proceeds to the [[Managing file and table size with FILEMGMT|File Size Definition screen]]. This screen displays information about the size of the file you are creating.</td>
</tr>
</tr>
<tr>
<tr>
<td>PF12 </td>
<td>F12 </td>
<td>END</td>
<td>END</td>
<td>Stages the file for CREATE or RECREATE. Exits from the Procedure screen and returns to the primary screen.</td>
<td>Stages the file for <var>CREATE</var> or <var>RECREATE</var>. Exits from the Procedure screen and returns to the FILEMGMT primary screen.</td>
</tr>
</tr>
</table>
</table>
<p>&nbsp;</p>
 
[[Category:File manager]]
 
[[Category:FILEMGMT application subsystem]]

Latest revision as of 04:20, 10 May 2014

If your file includes procedures, use the File Definition - Procedure screen to specify the Model 204 file parameters that describe the procedures stored in the file.

  • If the file is a data file, just use the defaults on this screen.
  • If this is a file for storing procedures, pay close attention to the values used in calculating PDSTRPPG and PDSIZE. If you underestimate these values, the procedure dictionary may fill and prevent the adding of more procedures into the file.

File Definition - Procedure screen

Press the F8 (FORward) key from the File Definition - Security screen. FILEMGMT displays the third File Definition Screen, the Procedure screen:

FILEMGMT File Definition - Procedure Page 3 of 3 Filename: ABC Inactive MAXIMUM PROCEDURE ENTRIES/TABLE D DICTIONARY PAGE PDSTRPPG: 128 PAGES IN TABLE D PROCEDURE DICTIONARY PDSIZE: 1 NUMBER OF PROCEDURE ENTRIES Current: 0 Expected: 0 AVERAGE PAGES PER PROC Current: 1 Expected: 1 Avg Procname Length: 20 DEFAULT PROCEDURE CLASS PRCLDEF: 0 ===> 1=HELp 2= 3=QUIt 4=FIElds 5= 6=COMmands 7=BACkward 8= 9=SIZe 10= 11= 12=END

When this screen is displayed for a file for the first time, FILEMGMT shows the standard Model 204 default values for the parameters.

You can specify values for these fields:

  • NUMBER OF PROCEDURE ENTRIES (Expected)
  • AVERAGE PAGES PER PROC (Expected)
  • Avg Procname Length
  • PRCLDEF

FILEMGMT uses the field values to calculate the values of PDSTRPPG (maximum procedure entries) and PDSIZE (pages in Table D procedure directory).

For a discussion of how to select the most appropriate parameter options for your particular file, refer to Sizing the procedure dictionary.

The cursor is initially positioned at the Expected prompt for NUMBER OF PROCEDURE ENTRIES.

Procedure screen input

FILEMGMT displays and/or prompts you for the following information:

Prompt Response
Filename FILEMGMT displays the name of the file that you entered on the primary screen, and indicates whether the file is Active or Inactive.
MAXIMUM PROCEDURE ENTRIES/TABLE D DICTIONARY PAGE
PDSTRPPG Displays the maximum number of procedure entries on a directory page. The value is calculated from:
  • Number of procedure entries
  • Average number of pages per procedure
  • Average procedure name length

The value in this input field is entry-protected Valid values are 1-256. The default is 128 entries.

PAGES IN TABLE D PROCEDURE DICTIONARY
PDSIZE Displays the number of contiguous pages in the procedure directory. PDSIZE must be less than the value of the DSIZE parameter on the File Size Definition screen. The value is calculated from:
  • Number of procedure entries
  • Average number of pages per procedure
  • Average procedure name length

Valid values are 1-255. The default is 3 pages.

NUMBER OF PROCEDURE ENTRIES
Current FILEMGMT displays the number of procedures currently defined in the procedure directory. The value in this input field is entry-protected.
Expected Specify the number of procedures you expect to store in the file. Valid values are 0 through the number of pages allowed in Table D, and null. The default is null.
AVERAGE PAGES PER PROC
Current FILEMGMT displays the average number of pages of the procedures currently stored in the file. The value in this input field is entry-protected. The default is 1.
Expected Specify the average number of pages of the procedures you expect to store in the file. Valid values are 1 through 999999, and null. The default is 1.
Avg Procname Length Specify the average length of the procedure names stored in the file. Valid values are 1 through 255. The default is 20 characters.
DEFAULT PROCEDURE CLASS
PRCLDEF Specify the default user class for procedures, if the file is public or semipublic. Valid values are 0 through 255. The default is 0.

Procedure screen commands

To issue a command, press a PF key or type a command name at the prompt (===>) and press Enter.

Key Command Meaning
F1 HELp Displays Help text for the File Definition - Procedure screen.
F3 QUIt Exits from the Procedure screen and returns to the primary screen without making any changes.
F4 FIElds Stages the file for CREATE or RECREATE. Proceeds to the Field Name List screen in DEFINE mode. This screen lists the fields in the file you are creating.
F6 COMmands Stages the file for CREATE or RECREATE. Proceeds to the Execute Commands screen. This screen displays the staged commands that were generated for the file and allows you to select the commands you want to execute.
F7 BACkward Proceeds to the File Definition - Security screen. This screen allows you to specify file security parameters for the file you are creating.
F9 SIZe Stages the file for CREATE or RECREATE. Proceeds to the File Size Definition screen. This screen displays information about the size of the file you are creating.
F12 END Stages the file for CREATE or RECREATE. Exits from the Procedure screen and returns to the FILEMGMT primary screen.