FILEMGMT overview: Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
m (add link)
 
(38 intermediate revisions by 6 users not shown)
Line 1: Line 1:
==Prerequisites==
<p>
In order to use FILEMGMT:</p>
<ul>
<li>You must have Dictionary/204 and its subsystems running.</li>
<li>You should have an understanding of <var class="product">Model&nbsp;204</var> file management. See [[File management overview]] for details.</li>
<li>You need file management privileges and the appropriate <var class="product">Model&nbsp;204</var> privileges:
<ul>
<li>Creating a new <var class="product">Model&nbsp;204</var> file requires login account privileges that include superuser privileges.</li>
<li> Changing an existing file requires a <var class="product">Model&nbsp;204</var> password indicating that you have the necessary update privileges for the file.</li>
</ul> </li>
</ul>
==Overview==
==Overview==
<p>You must have Dictionary/204 and its subsystems running in order to use FILEMGMT.</p>
<p>
<p>The Dictionary/204 File Management Subsystem facility, FILEMGMT, is a full-screen interface to <var class="product">Model&nbsp;204</var> file management. The facility enables you to create <var class="product">Model&nbsp;204</var> files quickly, reliably, and securely. You define a file and its contents on the series of screens that FILEMGMT provides. FILEMGMT uses your definitions to:</p>
The Dictionary/204 File Management Subsystem facility, FILEMGMT, is a [[FILEMGMT screens overview|3270-screen interface]] or a [[RKWeb|web-browser interface]] to <var class="product">Model&nbsp;204</var> file management.  
 
The FILEMGMT facility enables you to create <var class="product">Model&nbsp;204</var> files quickly, reliably, and securely. You define a file and its contents on the series of screens that FILEMGMT provides. FILEMGMT uses your definitions to:</p>
<ul>
<ul>
<li>Construct the <var class="product">Model&nbsp;204</var> commands that create the physical file</li>
<li>Construct the <var class="product">Model&nbsp;204</var> commands that create the physical file</li>
<li>Store the appropriate entries in your installation's dictionary </li>
<li>Store the appropriate entries in your installation's dictionary </li>
</ul>
</ul>
<p>By combining the two operations, FILEMGMT eliminates the need to enter this information twice. FILEMGMT validates the information for accuracy and consistency, and it creates and stores all necessary dictionary entries and references.</p>
<p>
<p>FILEMGMT does more than create new files. You can use the facility to:</p>
By combining the two operations, FILEMGMT eliminates the need to enter this information twice. FILEMGMT validates the information for accuracy and consistency, and it creates and stores all necessary dictionary entries and references.</p>
<p>
FILEMGMT does more than create new files. You can use the facility to:</p>
<ul>
<ul>
<li>View existing file data</li>
<li>View existing file data</li>
Line 15: Line 36:
<li>Copy files, fields, and records </li>
<li>Copy files, fields, and records </li>
</ul>
</ul>
<p>To use this facility, you need file management privileges and the appropriate <var class="product">Model&nbsp;204</var> privileges. Creating a new <var class="product">Model&nbsp;204</var> file requires login account privileges that include superuser privileges. Changing an existing file requires a <var class="product">Model&nbsp;204</var> password indicating that you have the necessary update privileges for the file. </p>
 
<p>This chapter assumes you have an understanding of <var class="product">Model&nbsp;204</var> file management. The Rocket <var class="product">Model&nbsp;204</var> File Manager's Guide provides an explanation of the <var class="product">Model&nbsp;204</var> parameters discussed in this chapter.</p>
==FILEMGMT maintenance functions==
==FILEMGMT maintenance functions==
<p>FILEMGMT consists of the following maintenance functions:</p>
<p>
FILEMGMT consists of the following maintenance functions:</p>
<ul>
<ul>
<li>File maintenance</li>
<li>File maintenance</li>
Line 25: Line 46:
<li>Field group maintenance </li>
<li>Field group maintenance </li>
</ul>
</ul>
<p>These maintenance functions let you define FILE, FIELD, RECORD, and FIELD GROUP entries, as well as modify and delete these entries. The facility also creates the actual files, fields, records, and field groups that correspond to the dictionary entries that you have defined or modified.</p>
<p>
<p>Each maintenance function has its own full-screen interface that you can select from the FILEMGMT primary screen. Using the facility screens you can specify the characteristics and relationships of your files, fields, records, and field groups. The FILEMGMT facility also sizes files automatically based on information you provide about file characteristics. The section [[ Managing File and Table Size with FILEMGMT#File sizing overview|File sizing overview]] explains in more detail how file sizing works.</p>
These maintenance functions let you define FILE, FIELD, RECORD, and FIELD GROUP entries, as well as modify and delete these entries. The facility also creates the actual files, fields, records, and field groups that correspond to the dictionary entries that you have defined or modified.</p>
<p>
Each maintenance function has its own full-screen interface that you can select from the FILEMGMT primary screen. Using the facility screens you can specify the characteristics and relationships of your files, fields, records, and field groups. The FILEMGMT facility also sizes files automatically based on information you provide about file characteristics. The section [[ Managing file and table size with FILEMGMT#File sizing overview|File sizing overview]] explains in more detail how file sizing works.</p>
 
==FILEMGMT and command execution==
==FILEMGMT and command execution==
<p>After you have defined the characteristics and relationships of an entry, FILEMGMT stages your entry for the specified commands. The commands can be executed in one of four active or inactive modes, depending upon the execution options that are supported at your installation. Your dictionary administrator selects a default mode, but you can override that selection with another supported option. The section [[#Dictionary/204 and staging|Dictionary/204 and staging]] explains the execution options in detail.</p>
<p>
<p>When the commands are executed, FILEMGMT creates the file, field, record, or field group as you have defined it. The facility also creates the corresponding (nonstaged) dictionary entry. The section [[#Staging entries|Staging entries]] explains staged and nonstaged entries.</p>
After you have defined the characteristics and relationships of an entry, FILEMGMT stages your entry for the specified commands. The commands can be executed in one of four active or inactive modes, depending upon the execution options that are supported at your installation. Your dictionary administrator selects a default mode, but you can override that selection with another supported option. The section [[#Dictionary/204 and staging|Dictionary/204 and staging]] explains the execution options in detail.</p>
<p>
When the commands are executed, FILEMGMT creates the file, field, record, or field group as you have defined it. The facility also creates the corresponding (non-staged) dictionary entry. The section [[#Staging entries|Staging entries]] explains staged and non-staged entries.</p>
<p>If it becomes necessary to modify an existing file, FILEMGMT locks all the file, field, record, and field group definitions for that file to protect the integrity of the dictionary data. The section [[#File locking|File locking]] explains file locking.</p>
<p>If it becomes necessary to modify an existing file, FILEMGMT locks all the file, field, record, and field group definitions for that file to protect the integrity of the dictionary data. The section [[#File locking|File locking]] explains file locking.</p>
===Staging entries===
===Staging entries===
<p>FILEMGMT coordinates these general activities:</p>
<p>
FILEMGMT coordinates these general activities:</p>
<ul>
<ul>
<li>Construction and execution of <var class="product">Model&nbsp;204</var> commands</li>
<li>Construction and execution of <var class="product">Model&nbsp;204</var> commands</li>
<li>Storage of entries in your installation's dictionary </li>
<li>Storage of entries in your installation's dictionary </li>
</ul>
</ul>
<p>The activities can be completed in a single FILEMGMT session or can be performed across multiple sessions. A dictionary entry containing your specifications is staged until all commands pertaining to the entry are executed. The entry is described as existing once execution is completed.</p>
<p>
<p>Some FILEMGMT functions let you operate on staged entries; others do not. The following descriptions of the FILEMGMT screens specify the circumstances under which you can redefine, delete, and rename staged entries.</p>
The activities can be completed in a single FILEMGMT session or can be performed across multiple sessions. A dictionary entry containing your specifications is staged until all commands pertaining to the entry are executed. The entry is described as existing once execution is completed.</p>
<p>
Some FILEMGMT functions let you operate on staged entries; others do not. The following descriptions of the FILEMGMT screens specify the circumstances under which you can redefine, delete, and rename staged entries.</p>
 
====Dictionary/204 and staging====
====Dictionary/204 and staging====
<p>Internally, Dictionary/204 manages staging by supporting two copies of every dictionary entry affected by your request. For example, if you are performing a file recreate, your request might affect entries of the following entity types in your installation's dictionary:</p>
<p>
Internally, Dictionary/204 manages staging by supporting two copies of every dictionary entry affected by your request. For example, if you are performing a file recreate, your request might affect entries of the following entity types in your installation's dictionary:</p>
<p class="code">FILE
<p class="code">FILE
FIELD
FIELD
Line 46: Line 78:
FIELD GROUP
FIELD GROUP
</p>
</p>
<p>Copies of these entries exist until your commands have been executed. The copies have the entity types of:</p>
<p>
Copies of these entries exist until your commands have been executed. The copies have the entity types of:</p>
<p class="code">STAGED FILE
<p class="code">STAGED FILE
STAGED FIELD
STAGED FIELD
Line 52: Line 85:
STAGED FIELD GROUP  
STAGED FIELD GROUP  
</p>
</p>
<p>The two copies are identical except that the staged version contains:</p>
<p>
The two copies are identical except that the staged version contains:</p>
<table>
<table>
<tr>
<tr>
Line 58: Line 92:
<td>Specifies the command to be generated</td>
<td>Specifies the command to be generated</td>
</tr>
</tr>
<tr>
<tr>
<td>COMMAND STATE attribute</td>
<td>COMMAND STATE attribute</td>
Line 63: Line 98:
</tr>
</tr>
</table>
</table>
<p>A file create request, unlike a file recreate, has only staged entries.</p>
<p>
<p>FILEMGMT copies an existing (or nonstaged) entry to a staged entry when you initiate a change to a file, field, record, or field group. When all relevant commands have been executed, FILEMGMT copies the staged entry to a nonstaged entry by deleting the nonstaged entry and renaming the staged entry as nonstaged.</p>
A file create request, unlike a file recreate, has only staged entries.</p>
===Executing commands===
<p>
<p>FILEMGMT constructs <var class="product">Model&nbsp;204</var> commands from the information you enter. The commands, when executed, perform the functions you requested from the primary screen.</p>
FILEMGMT copies an existing (or non-staged) entry to a staged entry when you initiate a change to a file, field, record, or field group. When all relevant commands have been executed, FILEMGMT copies the staged entry to a non-staged entry by deleting the non-staged entry and renaming the staged entry as non-staged.</p>
<p>The execution of a command depends upon the following factors:</p>
 
===How commands are executed===
<p>
FILEMGMT constructs <var class="product">Model&nbsp;204</var> commands from the information you enter. The commands, when executed, perform the functions you requested from the primary screen.</p>
<p>
The execution of a command depends upon the following factors:</p>
<ul>
<ul>
<li>Completeness of the request for a FILEMGMT function
<li>Completeness of the request for a FILEMGMT function
<p>For example, a file create function is not complete when you finish entering a file description, because the file must be sized. FILEMGMT must complete the description to construct the <var class="product">Model&nbsp;204</var> commands that perform the create operation.</p>
<p>
<p>Until your request is completely specified, and until the commands constructed from the request have actually been executed, your request is considered to be staged.</p>
For example, a file create function is not complete when you finish entering a file description, because the file must be sized. FILEMGMT must complete the description to construct the <var class="product">Model&nbsp;204</var> commands that perform the create operation.</p>
<p>To execute the commands, you advance to the Execute Commands screen, select the <var class="product">Model&nbsp;204</var> commands that are waiting to be executed, and press the PF6 (EXEcute) key.</p>
<p>
Until your request is completely specified, and until the commands constructed from the request have actually been executed, your request is considered to be staged.</p>
<p>To execute the commands, you advance to the Execute Commands screen, select the <var class="product">Model&nbsp;204</var> commands that are waiting to be executed, and press the F6 (EXEcute) key.</p>
</li>
</li>
<li>Execution option you select
<li>Execution option you select
<p>When Dictionary/204 is installed, the dictionary administrator determines which execution options are available to FILEMGMT users and which one is the default option. The execution option determines how staged <var class="product">Model&nbsp;204</var> commands are executed on the Execute Commands screen.</p>
<p>
When Dictionary/204 is installed, the dictionary administrator determines which execution options are available to FILEMGMT users and which one is the default option. The execution option determines how staged <var class="product">Model&nbsp;204</var> commands are executed on the Execute Commands screen.</p>
<p>The execution options are:</p>
<p>The execution options are:</p>
</li>
<ul>
<li>Active immediate</li>
<li>Active immediate</li>
<li>Active delayed</li>
<li>Active delayed</li>
<li>Inactive with commands written to a procedure file</li>
<li>Inactive with commands written to a procedure file</li>
<li>Inactive with commands written to a directed output file </li>
<li>Inactive with commands written to a directed output file </li>
</ul></li>
</ul>
</ul>
<p>Dictionary/204 provides an option for requiring that all commands against files be executed through the FILEMGMT interface.   </p>
<p>
Dictionary/204 provides an option for requiring that all commands against files be executed through the FILEMGMT interface. See [[Dictionary/204 administration#File Management options|File Management options]].</p>
 
====Execution options====
====Execution options====
<p>The options provided by FILEMGMT are listed in the following table. They are more fully described again in the section "Execute Commands screen".</p>
<p>
<b>Note</b>
The options provided by FILEMGMT are listed in the following table. They are more fully described again in [[Executing and deleting commands with FILEMGMT#Execute Commands screen|Execute Commands screen]].</p>
<p>If you select Inactive mode, then the Dictionary/204 files are updated, but not the physical files.  </p>
<p class="note"><b>Note:</b>
If you select Inactive mode, then the Dictionary/204 files are updated, but not the physical files.  </p>
<table>
<table>
<tr class="head">
<tr class="head">
Line 93: Line 141:
<th>Commands selected on the Execute Commands screen are...</th>
<th>Commands selected on the Execute Commands screen are...</th>
</tr>
</tr>
<tr>
<tr>
<td>Active immediate</td>
<td>Active immediate</td>
<td>Executed as soon as FILEMGMT verifies that you have the necessary privileges to execute the commands.</td>
<td>Executed as soon as FILEMGMT verifies that you have the necessary privileges to execute the commands.</td>
</tr>
</tr>
<tr>
<tr>
<td> Active delayed</td>
<td> Active delayed</td>
<td>
<td>Updated as pending and are executed at a later time in batch mode. FILEMGMT verifies that you have the necessary privileges to execute the commands before it flags them as pending.  
<p>Updated as pending and are executed at a later time in batch mode. FILEMGMT verifies that you have the necessary privileges to execute the commands before it flags them as pending. </p>
<p>
<p>Consult the Rocket <var class="product">Model&nbsp;204</var> Installation Guide for your operating system for information about the JCL or CCAIN statements you need to include for a batch run.  </p>
Consult the Rocket <var class="product">Model&nbsp;204</var> Installation Guide for your operating system for information about the JCL or CCAIN statements you need to include for a batch run.  </p>
</td>
</td></tr>
</tr>
 
<tr>
<tr>
<td> Inactive USE file</td>
<td> Inactive USE file</td>
<td>
<td>Not executed. Instead, they are generated and written to a directed output USE file. You specify the name of this file on the Execute Commands screen. OUTFILE is the default if you do not specify a file name.
<p>Not executed. Instead, they are generated and written to a directed output USE file. You specify the name of this file on the Execute Commands screen. OUTFILE is the default if you do not specify a file name. </p>
<p>
<p>A default USE file can be defined by the dictionary administrator in the Facility Administration feature of the Dictionary Administration facility or obtained from the user's ACCOUNT entry. </p>
A default USE file can be defined by the dictionary administrator in the Facility Administration feature of the Dictionary Administration facility or obtained from the user's ACCOUNT entry. </p>
<p>The section [[ Executing and Deleting Commands with FILEMGMT#Execute Commands screen|Execute Commands screen]] describes the JCL you need to include for the USE file.</p>
<p>
</td>
The section [[ Executing and deleting commands with FILEMGMT#Execute Commands screen|Execute Commands screen]] describes the JCL you need to include for the USE file.</p>
</tr>
</td></tr>
 
<tr>
<tr>
<td> Inactive procedure file</td>
<td nowrap>Inactive procedure file</td>
<td>
<td>Not executed. Instead, they are generated and written to a procedure file. You specify the name of the procedure file and its password (if any) on the Execute Commands screen.  
<p>Not executed. Instead, they are generated and written to a procedure file. You specify the name of the procedure file and its password (if any) on the Execute Commands screen. </p>
<p>
<p>The dictionary administrator can define a default procedure file in the Facility Administration feature of the Dictionary Administration facility. </p>
The dictionary administrator can define a default procedure file in the Facility Administration feature of the Dictionary Administration facility. </p>
</td>
</td></tr>
</tr>
</table>
</table>
===File locking===
 
<p>FILEMGMT provides a file locking capability to control file access and enhance data integrity. While you are creating a file or making any changes to the file definition, the file lock prevents other users from changing the file's:</p>
==File locking==
<p>
FILEMGMT provides a file locking capability to control file access and enhance data integrity. While you are creating a file or making any changes to the file definition, the file lock prevents other users from changing the file's:</p>
<ul>
<ul>
<li>Definitions</li>
<li>Definitions</li>
Line 127: Line 179:
<li>Parameters and other characteristics</li>
<li>Parameters and other characteristics</li>
</ul>
</ul>
<p>The file lock is maintained until you release the file by either executing or deleting the commands that FILEMGMT constructed. Your work can span multiple FILEMGMT sessions, if desired. Dictionary/204 maintains the file lock across sessions by keeping track of the account name. Only users who log in with the appropriate account name have access to the file. </p>
<p>
==FILEMGMT screens==
The file lock is maintained until you release the file by either executing or deleting the commands that FILEMGMT constructed. Your work can span multiple FILEMGMT sessions, if desired. Dictionary/204 maintains the file lock across sessions by keeping track of the account name. Only users who log in with the appropriate account name have access to the file. </p>
<p>Like all Dictionary/204 facilities, FILEMGMT provides a series of screens that let you select functions, view stored information, and enter new information. Specifically, FILEMGMT screens:</p>
==Other FILEMGMT topics==
<ul>
<ul>
<li>Prompt for information such as file options and parameters. Defaults are provided, so that you need enter only the information that differs from the defaults.</li>
<li>[[FILEMGMT screens overview]] </li>
<li>Enable you to select a function from the screen or proceed to another screen using one of the following methods:</li>
<li>[[Logging on to FILEMGMT]] </li>
<li>Press a PF key</li>
<li>Enter a command at the prompt (===>) on the screen's command line.
<p>You can press Enter on any screen; the screen is redisplayed with the changes you specified. To update the dictionary, however, you must use a PF key or enter a command. </p>
</li>
<li>Enable you to invoke HELP text for the screen. To invoke HELP text, press the PF1 key or type "HELp" on the command line.  </li>
<li>Flag error conditions and display error messages. FILEMGMT identifies errors in your entries by a less than (&lt; ) sign in the right margin. Press Enter to view the messages associated with these errors. If you have only one error, the error message is displayed on the screen's message line below the command line. </li>
<li>Provide a menu from which you make your selection for a file management function. This menu is referred to in this chapter as the primary screen.    </li>
</ul>
</ul>
==Logging on to FILEMGMT==
<p>The FILEMGMT subsystem must be started before you can use the following methods to log on to the FILEMGMT facility. If the subsystem has not been started, contact your dictionary administrator.</p>
<p>To log on to the FILEMGMT facility, you choose one of the following methods:</p>
<ul>
<li>Select the File Management option from the Dictionary /204 main menu.</li>
</ul>
<b>Note</b>
<p>The absence of the File Management option from your main menu means you are not authorized to use this facility.</p>
<ul>
<li>Invoke FILEMGMT from the primary screen of another Dictionary/204 or Workshop/204 facility by issuing the INVOKE command. The command syntax is:
<p class="code">INVoke FILEMGMT
</p></li>
<li>Call the FILEMGMT subsystem from the <var class="product">Model&nbsp;204</var> command prompt by typing the subsystem name:
<p class="code">> FILEMGMT
</p></li>
</ul>
==FILEMGMT primary screen==
<p>The FILEMGMT primary screen is displayed when you log on to FILEMGMT: </p>
<table>
<tr>
<td>
<p class="code">DICTIONARY              FILE MANAGEMENT                        VER 6 REL 1
Filename:
                                Enter option number in one prefix area


      _ File                _ Field      _ Record      _ Field Group
==See also==
_________________________    __________    __________    ______________
{{Template: Dictionary/204 topic list}}
1 CREATE    7 INCREASE      1 DEFINE      1 Define      1 Define
2 RESET      8 DECREASE      2 REDEFINE    2 Redefine    2 Redefine
3 Delete    9 SECURE        3 DELETE      3 Delete      3 Delete
4 ReCREATE  10 DESECURE      4 RENAME      4 Rename      4 Rename
5 Copy      11 INITIALIZE    5 Copy        5 Copy
6 Size


Field, Record or Field Group Name:
[[Category:FILEMGMT application subsystem]]
 
[[Category: Overviews]]
 
===>
 
1=HELp    2=DOCument  3=QUIt        4=        5=        6=COMmands
7=        8=          9=DELcmds    10=      11=      12=
</p></td>
</tr>
</table>
<p>Capitalized function names refer to actual <var class="product">Model&nbsp;204</var> commands (for example, CREATE, DECREASE). Function names in mixed case refer to functions that FILEMGMT performs upon dictionary entries only.</p>
<p>You can select a maintenance function from these categories:</p>
<table>
<tr>
<td>FILE Maintenance</td>
<td>Creates a new <var class="product">Model&nbsp;204</var> file, determines the size of a file, recreates or modifies the parameters of an existing file, deletes or copies a file, and performs other file maintenance functions.</td>
</tr>
<tr>
<td> FIELD Maintenance</td>
<td>Defines fields for a new or existing file, changes existing field names or attributes, and performs other field maintenance functions.</td>
</tr>
<tr>
<td> RECORD Maintenance</td>
<td>Defines records for a new or existing file, changes existing record names or characteristics, and performs other record maintenance functions.</td>
</tr>
<tr>
<td> FIELD GROUP Maintenance</td>
<td>Defines field groups for a new or existing file, changes existing field group names or contents, and performs other field group maintenance functions.</td>
</tr>
</table>
===FILEMGMT functions===
<p>This section presents an overview of FILEMGMT functions. All functions can be selected from the primary screen. The functions are described in detail in the rest of this chapter.</p>
====File maintenance====
<table>
<tr class="head">
<th>Number </th>
<th> Function</th>
<th>Meaning</th>
</tr>
<tr>
<td align="right"> 1 </td>
<td>CREATE</td>
<td>Adds a new <var class="product">Model&nbsp;204</var> file. Proceeds to the File Definition - Organization screen.</td>
</tr>
<tr>
<td align="right"> 2 </td>
<td>RESET</td>
<td>Changes the values of file parameters. Proceeds to the File Parameter Reset screen.</td>
</tr>
<tr>
<td align="right"> 3</td>
<td> Delete</td>
<td>Removes a file with its field, record, and field group entries from the dictionary. Proceeds to the File Delete screen.</td>
</tr>
<tr>
<td align="right"> 4</td>
<td> ReCREATE</td>
<td>Recreates a <var class="product">Model&nbsp;204</var> file in order to reorganize the file. Proceeds to the File Definition - Organization screen.</td>
</tr>
<tr>
<td align="right"> 5</td>
<td> Copy</td>
<td>Copies a file and optionally its record and field definitions. Proceeds to the Copy screen for files.</td>
</tr>
<tr>
<td align="right"> 6</td>
<td> Size</td>
<td>Sizes a file. Proceeds to the File Size Definition screen.</td>
</tr>
<tr>
<td align="right"> 7</td>
<td> INCREASE</td>
<td>Increases the file table sizes of an existing file. Proceeds to the File Increase/Decrease screen.</td>
</tr>
<tr>
<td align="right"> 8 </td>
<td>DECREASE</td>
<td>Decreases the file table sizes of an existing file. Proceeds to the File Increase/Decrease screen.</td>
</tr>
<tr>
<td align="right"> 9 </td>
<td>SECURE</td>
<td>Secures the file.</td>
</tr>
<tr>
<td align="right"> 10 </td>
<td>DESECURE </td>
<td>Desecures the file.</td>
</tr>
<tr>
<td align="right"> 11 </td>
<td>INITIALIZE</td>
<td>Initializes an existing file. Proceeds to the File Initialize screen.</td>
</tr>
</table>
====FIELD maintenance====
<table>
<tr class="head">
<th>Number </th>
<th>Function</th>
<th>Meaning</th>
</tr>
<tr>
<td align="right"> 1</td>
<td> DEFINE</td>
<td>Defines a new field in the file. If no field name is specified, proceeds to the Field Name List screen. If a field name is specified, proceeds to the Field Attributes screen.</td>
</tr>
<tr>
<td align="right"> 2 </td>
<td>REDEFINE </td>
<td>Changes a field definition. If no field name is specified, proceeds to the Field Name List screen. If a field name is specified, proceeds to the Field Attributes screen.</td>
</tr>
<tr>
<td align="right"> 3</td>
<td>DELETE</td>
<td>Deletes a field, proceeds to the Field Attributes screen.</td>
</tr>
<tr>
<td align="right"> 4 </td>
<td>RENAME</td>
<td>Renames a field, proceeds to the Field Attributes screen.</td>
</tr>
<tr>
<td align="right"> 5 </td>
<td>Copy</td>
<td>Copies a field; if no field name is specified, copies all fields in the file. Proceeds to the Copy screen.</td>
</tr>
</table>
====RECORD maintenance====
<table>
<tr class="head">
<th>Number </th>
<th>Function </th>
<th>Meaning</th>
</tr>
<tr>
<td align="right"> 1</td>
<td>Define</td>
<td>Defines a new record in the file. Proceeds to the Record Name List screen.</td>
</tr>
<tr>
<td align="right"> 2 </td>
<td>Redefine</td>
<td>Changes a record definition. Proceeds to the Record Name List screen.</td>
</tr>
<tr>
<td align="right"> 3 </td>
<td>Delete</td>
<td>Deletes a record. Proceeds to the Record Name List screen.</td>
</tr>
<tr>
<td align="right"> 4</td>
<td>Rename</td>
<td>Renames a record. Proceeds to the Record Name List screen.</td>
</tr>
<tr>
<td align="right"> 5 </td>
<td>Copy</td>
<td>Copies a record if no record name is specified, copies all records in the file. Proceeds to the Copy screen.</td>
</tr>
</table>
====FIELD GROUP maintenance====
<table>
<tr class="head">
<th> Number </th>
<th>Function </th>
<th>Meaning </th>
</tr>
<tr>
<td align="right"> 1 </td>
<td>Define</td>
<td>Defines a new field group in the file. Proceeds to the Field Group List screen.</td>
</tr>
<tr>
<td align="right"> 2 </td>
<td>Redefine</td>
<td>Changes a field group definition. Proceeds to the Field Group List screen.</td>
</tr>
<tr>
<td align="right"> 3 </td>
<td>Delete</td>
<td>Deletes a field group. Proceeds to the Field Group List screen.</td>
</tr>
<tr>
<td align="right"> 4</td>
<td>Rename</td>
<td>Renames a field group. Proceeds to the Field Group List screen.</td>
</tr>
</table>
===WARNING messages===
<p>FILEMGMT might generate WARNING messages when you store dictionary data. WARNING messages are informational messages. They indicate potential user errors, although the errors usually do not cancel Dictionary/204 processing.</p>
<p>Assume, for example, that Access/204 is installed at your site and you define a field without entering a MAX OCCURS value, which is required by Access/204. FILEMGMT warns you that the value is missing by issuing the following message, but nevertheless allows you to store the field definition:</p>
<p class="code">FIM472 WARN: MAX OCCURS is null. Used by ACCESS.
</p>
<p>You can choose to either continue processing despite a potential error by pressing the appropriate PF key again, or supply a missing value or otherwise correct the error before you reissue the command.</p>
===Widen screen===
<p>FILEMGMT provides a Widen screen, which enables you to enter or display names that do not fit on other FILEMGMT screens. The names might belong to:</p>
<ul>
<li>Fields, including sort keys, hash keys, record security keys, and record identifying fields</li>
<li>Records or record types</li>
<li>Field groups </li>
</ul>
<p>The names have a maximum length of 70 characters.</p>
====Widening the screen====
<p>To use the Widen screen from any of the FILEMGMT screens that support the WIDen command:</p>
<ol>
<li>Position the cursor on the name you want to widen.</li>
<li>Press PF5. FILEMGMT displays the Widen screen.</li>
<li>Type additional characters for the entry if you choose.</li>
<li>Press PF12 to enter the new name and return to the previous screen. </li>
</ol>
<p>The record name is displayed in its truncated form on the Record Name List screen. To view the complete record name, request the Widen screen again.</p>
<p>If using the WIDen command to view an entry-protected name or value that you cannot alter, press PF3 (QUIt) to return to the previous screen.</p>
<p>&nbsp;</p>
[[Category:File manager]]
[[:Category:File Management]]
[[:Category:FILEMGMT Application Subsystem]]

Latest revision as of 00:16, 17 June 2017

Prerequisites

In order to use FILEMGMT:

  • You must have Dictionary/204 and its subsystems running.
  • You should have an understanding of Model 204 file management. See File management overview for details.
  • You need file management privileges and the appropriate Model 204 privileges:
    • Creating a new Model 204 file requires login account privileges that include superuser privileges.
    • Changing an existing file requires a Model 204 password indicating that you have the necessary update privileges for the file.

Overview

The Dictionary/204 File Management Subsystem facility, FILEMGMT, is a 3270-screen interface or a web-browser interface to Model 204 file management. The FILEMGMT facility enables you to create Model 204 files quickly, reliably, and securely. You define a file and its contents on the series of screens that FILEMGMT provides. FILEMGMT uses your definitions to:

  • Construct the Model 204 commands that create the physical file
  • Store the appropriate entries in your installation's dictionary

By combining the two operations, FILEMGMT eliminates the need to enter this information twice. FILEMGMT validates the information for accuracy and consistency, and it creates and stores all necessary dictionary entries and references.

FILEMGMT does more than create new files. You can use the facility to:

  • View existing file data
  • Reset file parameters
  • Add fields, records, and field groups to existing files
  • Calculate and change the size of a file
  • Copy files, fields, and records

FILEMGMT maintenance functions

FILEMGMT consists of the following maintenance functions:

  • File maintenance
  • Field maintenance
  • Record maintenance
  • Field group maintenance

These maintenance functions let you define FILE, FIELD, RECORD, and FIELD GROUP entries, as well as modify and delete these entries. The facility also creates the actual files, fields, records, and field groups that correspond to the dictionary entries that you have defined or modified.

Each maintenance function has its own full-screen interface that you can select from the FILEMGMT primary screen. Using the facility screens you can specify the characteristics and relationships of your files, fields, records, and field groups. The FILEMGMT facility also sizes files automatically based on information you provide about file characteristics. The section File sizing overview explains in more detail how file sizing works.

FILEMGMT and command execution

After you have defined the characteristics and relationships of an entry, FILEMGMT stages your entry for the specified commands. The commands can be executed in one of four active or inactive modes, depending upon the execution options that are supported at your installation. Your dictionary administrator selects a default mode, but you can override that selection with another supported option. The section Dictionary/204 and staging explains the execution options in detail.

When the commands are executed, FILEMGMT creates the file, field, record, or field group as you have defined it. The facility also creates the corresponding (non-staged) dictionary entry. The section Staging entries explains staged and non-staged entries.

If it becomes necessary to modify an existing file, FILEMGMT locks all the file, field, record, and field group definitions for that file to protect the integrity of the dictionary data. The section File locking explains file locking.

Staging entries

FILEMGMT coordinates these general activities:

  • Construction and execution of Model 204 commands
  • Storage of entries in your installation's dictionary

The activities can be completed in a single FILEMGMT session or can be performed across multiple sessions. A dictionary entry containing your specifications is staged until all commands pertaining to the entry are executed. The entry is described as existing once execution is completed.

Some FILEMGMT functions let you operate on staged entries; others do not. The following descriptions of the FILEMGMT screens specify the circumstances under which you can redefine, delete, and rename staged entries.

Dictionary/204 and staging

Internally, Dictionary/204 manages staging by supporting two copies of every dictionary entry affected by your request. For example, if you are performing a file recreate, your request might affect entries of the following entity types in your installation's dictionary:

FILE FIELD RECORD FIELD GROUP

Copies of these entries exist until your commands have been executed. The copies have the entity types of:

STAGED FILE STAGED FIELD STAGED RECORD STAGED FIELD GROUP

The two copies are identical except that the staged version contains:

COMMAND attribute Specifies the command to be generated
COMMAND STATE attribute Indicates the status of the command

A file create request, unlike a file recreate, has only staged entries.

FILEMGMT copies an existing (or non-staged) entry to a staged entry when you initiate a change to a file, field, record, or field group. When all relevant commands have been executed, FILEMGMT copies the staged entry to a non-staged entry by deleting the non-staged entry and renaming the staged entry as non-staged.

How commands are executed

FILEMGMT constructs Model 204 commands from the information you enter. The commands, when executed, perform the functions you requested from the primary screen.

The execution of a command depends upon the following factors:

  • Completeness of the request for a FILEMGMT function

    For example, a file create function is not complete when you finish entering a file description, because the file must be sized. FILEMGMT must complete the description to construct the Model 204 commands that perform the create operation.

    Until your request is completely specified, and until the commands constructed from the request have actually been executed, your request is considered to be staged.

    To execute the commands, you advance to the Execute Commands screen, select the Model 204 commands that are waiting to be executed, and press the F6 (EXEcute) key.

  • Execution option you select

    When Dictionary/204 is installed, the dictionary administrator determines which execution options are available to FILEMGMT users and which one is the default option. The execution option determines how staged Model 204 commands are executed on the Execute Commands screen.

    The execution options are:

    • Active immediate
    • Active delayed
    • Inactive with commands written to a procedure file
    • Inactive with commands written to a directed output file

Dictionary/204 provides an option for requiring that all commands against files be executed through the FILEMGMT interface. See File Management options.

Execution options

The options provided by FILEMGMT are listed in the following table. They are more fully described again in Execute Commands screen.

Note: If you select Inactive mode, then the Dictionary/204 files are updated, but not the physical files.

Option Commands selected on the Execute Commands screen are...
Active immediate Executed as soon as FILEMGMT verifies that you have the necessary privileges to execute the commands.
Active delayed Updated as pending and are executed at a later time in batch mode. FILEMGMT verifies that you have the necessary privileges to execute the commands before it flags them as pending.

Consult the Rocket Model 204 Installation Guide for your operating system for information about the JCL or CCAIN statements you need to include for a batch run.

Inactive USE file Not executed. Instead, they are generated and written to a directed output USE file. You specify the name of this file on the Execute Commands screen. OUTFILE is the default if you do not specify a file name.

A default USE file can be defined by the dictionary administrator in the Facility Administration feature of the Dictionary Administration facility or obtained from the user's ACCOUNT entry.

The section Execute Commands screen describes the JCL you need to include for the USE file.

Inactive procedure file Not executed. Instead, they are generated and written to a procedure file. You specify the name of the procedure file and its password (if any) on the Execute Commands screen.

The dictionary administrator can define a default procedure file in the Facility Administration feature of the Dictionary Administration facility.

File locking

FILEMGMT provides a file locking capability to control file access and enhance data integrity. While you are creating a file or making any changes to the file definition, the file lock prevents other users from changing the file's:

  • Definitions
  • Fields, records, and field groups
  • Parameters and other characteristics

The file lock is maintained until you release the file by either executing or deleting the commands that FILEMGMT constructed. Your work can span multiple FILEMGMT sessions, if desired. Dictionary/204 maintains the file lock across sessions by keeping track of the account name. Only users who log in with the appropriate account name have access to the file.

Other FILEMGMT topics

See also