This file is the Database Name file. It is unused. It exists for use by a future version of MAGEC.<br />Logical Rec. Lgth:&nbsp;1016&nbsp; CI Size:&nbsp;2048&nbsp; Key Displacement:&nbsp;36&nbsp; Key Lgth:&nbsp;3<br />## <br />DCL (and its alias: DC$)<br />This is the Data Class file. It contains the definitions for each Data Class (application file), including record length, access method, etc.<br />Logical Rec. Lgth:&nbsp;1016&nbsp; CI Size:&nbsp;2048&nbsp; Key Displacement:&nbsp;36&nbsp; Key Lgth:&nbsp;3<br />## <br />DIT (and its alias: DI$)<br />This is the Data Item file. It contains the detailed definitions for each data item (field) of each element.<br />Logical Rec. Lgth:&nbsp;1016&nbsp; CI Size:&nbsp;2048&nbsp; Key Displacement:&nbsp;36&nbsp; Key Lgth:&nbsp;12<br />## <br />DOC<br />This is the Documentation file. It contains the actual text for the function-level help screens plus any other documentation recorded by your staff.<br />Logical Rec. Lgth:&nbsp;1200&nbsp; CI Size:&nbsp;4096&nbsp; Key Displacement:&nbsp;36&nbsp; Key Lgth:&nbsp;32<br />## <br />DVC<br />This is the Device file. It contains the definitions for printers and video terminals. These definitions are optional, (cont.)<br />they are needed only if you desire to use the TP Spooler, 7-color video, or terminal security (cont.)<br />features.<br />Logical Rec. Lgth:&nbsp;200&nbsp; CI Size:&nbsp;2048&nbsp; Key Displacement:&nbsp;0&nbsp; Key Lgth:&nbsp;4<br />## <br />ELT (and its alias: EL$)<br />This is the Element file. It contains definitions for data elements, segments of records, and is part of the data definition portion of the dictionary.<br />Logical Rec. Lgth:&nbsp;1016&nbsp; CI Size:&nbsp;2048&nbsp; Key Displacement:&nbsp;36&nbsp; Key Lgth:&nbsp;5<br />## <br />ERR<br />This is the Error file. It contains error messages and associated help text.<br />Logical Rec. Lgth:&nbsp;392&nbsp; CI Size:&nbsp;2048&nbsp; Key Displacement:&nbsp;36&nbsp; Key Lgth:&nbsp;3<br />## <br />FCD<br />This is the Function Code file. It contains definitions and security parameters for each online function code.<br />Logical Rec. Lgth:&nbsp;100&nbsp; CI Size:&nbsp;2048&nbsp; Key Displacement:&nbsp;36&nbsp; Key Lgth:&nbsp;6<br />## <br />GCO<br />This file only exists in a GUI environment. It is used to store the user color preferences for each user.<br />Logical Rec. Lgth:&nbsp;1200&nbsp; CI Size:&nbsp;4096&nbsp; Key Displacement:&nbsp;0&nbsp; Key Lgth:&nbsp;11<br />## <br />KYF (and its alias: KY$)<br />This is the Key Format file. It contains the definitions for the file keys and editing and formatting rules for their component fields.<br />Logical Rec. Lgth:&nbsp;1016&nbsp; CI Size:&nbsp;2048&nbsp; Key Displacement:&nbsp;36&nbsp; Key Lgth:&nbsp;5<br />## <br />LAP<br />This is the Logical Application file. It contains the definitions for each Logical Application (high-level menu item).<br />Logical Rec. Lgth:&nbsp;77&nbsp; CI Size:&nbsp;2048&nbsp; Key Displacement:&nbsp;36&nbsp; Key Lgth:&nbsp;2<br />## <br />MAL<br />This is the MAGEC Activity Log file. It contains the accumulated statistics gathered by the Activity Logging, if it is turned on.<br />Logical Rec. Lgth:&nbsp;36&nbsp; CI Size:&nbsp;2048&nbsp; Key Displacement:&nbsp;00&nbsp; Key Lgth:&nbsp;14<br />## <br />MMP<br />This is the MMP definition file. It contains the high-level definitions for each MAGEC Message Processor (online program).<br />Logical Rec. Lgth:&nbsp;100&nbsp; CI Size:&nbsp;2048&nbsp; Key Displacement:&nbsp;0&nbsp; Key Lgth:&nbsp;3<br />## <br />MSK or MS3<br />This is the Mask Initialization file (replaced by the MS3 file in MAGEC 3.0 and later). It contains the actual initialization record plus edit parameters for each screen format mask.<br />MSK Logical Rec. Lgth:&nbsp;3904&nbsp; CI Size:&nbsp;4096&nbsp; Key Displacement:&nbsp;0&nbsp; Key Lgth:&nbsp;4<br />MS3 Logical Rec. Lgth:&nbsp;5870&nbsp; CI Size:&nbsp;5870&nbsp; Key Displacement:&nbsp;0&nbsp; Key Lgth:&nbsp;4<br />## <br />MSKPAN.UIB<br />This is the Mask Panel file. It contains the actual GUI panels for each screen format mask, plus special panels for MAGEC system functions.<br />GUI mode only, accessible only via MAGEC GUI screen painter, other system functions<br />## <br />PRM<br />This is the Insertion Parm file. It contains the definition of each customization insertion point, both for online and (cont.)<br />batch programs. It also contains the proforma and online help for that insertion point.<br />Logical Rec. Lgth:&nbsp;2236&nbsp; CI Size:&nbsp;4096&nbsp; Key Displacement:&nbsp;37&nbsp; Key Lgth:&nbsp;7<br />## <br />REF<br />This is the documentation Reference file. It contains cross-reference records which associate topics from the DOC file (cont.)<br />to key words or key phrases. One of the prime purposes for this is to connect documentation topics to online functions (cont.)<br />for the high-level help key (PF1).<br />Logical Rec. Lgth:&nbsp;100&nbsp; CI Size:&nbsp;2048&nbsp; Key Displacement:&nbsp;36&nbsp; Key Lgth:&nbsp;64<br />## <br />RPH<br />This is the Report Header file. It is used to control the routing and disposition of reports by the TP Spooler feature.<br />Logical Rec. Lgth:&nbsp;100&nbsp; CI Size:&nbsp;2048&nbsp; Key Displacement:&nbsp;00&nbsp; Key Lgth:&nbsp;6<br />## <br />SCF<br />This is the Screen Field file. It contains the definitions and edit rules for each screen field on each mask.<br />Logical Rec. Lgth:&nbsp;320&nbsp; CI Size:&nbsp;2048&nbsp; Key Displacement:&nbsp;00&nbsp; Key Lgth:&nbsp;10<br />## <br />SHD<br />This is the Screen Header file. It contains the high-level parameters and definitions for each screen mask, including responsible programmer.<br />Logical Rec. Lgth:&nbsp;150&nbsp; CI Size:&nbsp;2048&nbsp; Key Displacement:&nbsp;00&nbsp; Key Lgth:&nbsp;4<br />## <br />SIF<br />This is the Security Information file. It contains the security profile for each operator authorized to use the system.<br />Logical Rec. Lgth:&nbsp;300&nbsp; CI Size:&nbsp;2048&nbsp; Key Displacement:&nbsp;36&nbsp; Key Lgth:&nbsp;6<br />## <br />SPL<br />This is the Spool file. It contains the actual report text to be routed by the TP Spooler feature.<br />Logical Rec. Lgth:&nbsp;1940&nbsp; CI Size:&nbsp;4096&nbsp; Key Displacement:&nbsp;00&nbsp; Key Lgth:&nbsp;5<br />## <br />TBL<br />This is the Table file. It contains lookup tables plus the table of contents which defines each table.<br />Logical Rec. Lgth:&nbsp;100&nbsp; CI Size:&nbsp;2048&nbsp; Key Displacement:&nbsp;36&nbsp; Key Lgth:&nbsp;19<br />## <br />TST<br />This is the Test file. It is used in the tutorial projects to contain the Vacation data (VAC), and possibly in other test applications to demonstrate various features of MAGEC.<br />Logical Rec. Lgth:&nbsp;270&nbsp; CI Size:&nbsp;2048&nbsp; Key Displacement:&nbsp;36&nbsp; Key Lgth:&nbsp;18<br />## <br />TWA or TW3<br />This is the Task Work Area file (replaced by the TW3 file in MAGEC 3.0 and later). It is used to save TWA data to (cont.)<br />provide pseudo-conversational processing and for copy/paste, swap windows, and online help.<br />TWA Logical Rec. Lgth:&nbsp;04088&nbsp; CI Size:&nbsp;08192&nbsp; Key Displacement:&nbsp;00&nbsp; Key Lgth:&nbsp;8<br />TW3 Logical Rec. Lgth:&nbsp;16376&nbsp; CI Size:&nbsp;16376&nbsp; Key Displacement:&nbsp;00&nbsp; Key Lgth:&nbsp;8<br />**<br />NOTE:<br />**<br />For system tuning to obtain the best online performance of generated MAGEC applications, it is important that the TWA (cont.)<br />file be optimized. This means that you may wish to alter the CI Size, move the file to a less-used disk unit, separate (cont.)<br />the index and data areas, or apply any other tuning techniques dictated by your usage statistics. You should certainly (cont.)<br />consider frequent re-organizations. Purging old, unneeded records will also help performance. There is a batch utility (cont.)<br />named TWAUTIL which will automatically do that; there is also an online function: TWAPUR. Another method for recovering (cont.)<br />space in the TWA file is to completely purge it periodically. This can be done by erasing the file (on mainframe, use (cont.)<br />IDCAMS DELETE / DEFINE) and re-initializing it using MAGINIT. In a Micro Focus environment it is not necessary to do (cont.)<br />the MAGINIT since MAGEC's I/O module will re-create the TWA file if it is not found. In a network environment you may (cont.)<br />find it beneficial to put the TWA file on the local drives of your workstations. To do that simply specify "C:" on the (cont.)<br />KYF drive-id definition for TW3K1.<br /># <br />PC Template<br /># <br />Global Parameters<br />## <br />Table #243<br />Table #243 is an ordinary MAGEC Lookup Table which is used to contain certain system parameters. These parameters (cont.)<br />control the operation of the entire MAGEC system. If you are authorized to do so, you can alter any of these (cont.)<br />parameters' settings and dynamically change the way MAGEC operates without having to re-cycle your online system or (cont.)<br />re-compile any programs.<br />The parameter settings are loaded from Table #243 into main memory at system startup time. This is done for performance (cont.)<br />efficiency. You can tell MAGEC to re-load its main memory images from Table #243 by issuing the **LOAD command online (cont.)<br />after you have altered some settings. This is similar to the way that a database administrator or security officer can (cont.)<br />alter parameters and cause them to be re-loaded dynamically. This scheme gives you the advantages of a central (cont.)<br />repository without the overhead disadvantages of excessive I/O activity to the repository files.<br />Table #243 is, of course, a part of the repository (just like any other Lookup Table) and is saved to disk whenever you (cont.)<br />make any updates. Therefore, your changes will remain in effect until they are removed or changed (cont.)<br />again.<br />To do maintenance to Table #243 you could use the standard TBLCHG 243/xxx command format, as for any other Table; or (cont.)<br />you could use the special set of functions provided specifically for maintaining Table #243. They (cont.)<br />are:<br />243ADD<br />**243CHG<br />243LOC<br />et cetera<br />&nbsp;<br />The standard set of nine functions is provided.<br />To list the table's entries, you can use the command:<br />243LOC<br />&nbsp;<br />no key value is required for the browses. The program will begin at the start of Table #243.<br />To update a particular entry, you could use the command:<br />243CHG parameter-name<br />&nbsp;<br />where parameter-name is the up-to-16-character name for the desired parameter. These names are pre-set by MAGEC and (cont.)<br />cannot be altered by you. If you add an entry for a parameter which is not defiend to MAGEC, it will simply be ignored (cont.)<br />by the system. Likewise, if you were to misspell a parameter name when you added an entry for it. For the most part, (cont.)<br />you need not ever add any parameter entries since they are already loaded into the table when the system is installed. (cont.)<br />You will normally only ever have to change the settings for them.<br />When you use the 243CHG function, the screen will display a heading indicating that this is the MAGEC Configuration Parms screen, and it will display three data fields:<br />Parameter<br />the name of this parameter (same as in SKEY)<br />Setting<br />the value the parameter is set to<br />Comments<br />a description of this parameter<br />The first field, Parameter, is a protected field and cannot be altered by you.<br />The second field is the value this parameter is currently set to. You can change it online, if you wish. It is a (cont.)<br />10-character field. Most parameter settings are less than 10 characters long, therefore, you should enter your desired (cont.)<br />setting left-justified with spaces padding the remainder of the setting field.<br />The third field is a free-form comments area. It is used simply to document the meaning of this parameter, or, in some (cont.)<br />cases, the valid values (if there are only a few possibilities). You can alter this field, but there does not seem to (cont.)<br />be much reason for you to do so. Each parameter is pre-defined with a description which the MAGEC developers felt would (cont.)<br />be useful to you.<br />The parameters, and their valid settings are:<br />## <br />ALPHA-DATE<br />This may be set to either YES or NO. A value of YES indicates that dates which have an Edit Type of D should be (cont.)<br />displayed in the format DDMMMYY (as: 04JUL91), rather than the default format for Edit Type D (cont.)<br />(DD/MM/YY).<br />## <br />CLEAR-MMP<br />This indicates the 3-character MMP number of the clear screen MMP. It is set to 652 and should be left that way unless you are directed otherwise by the MAGEC support personnel.<br />## <br />CPMOD-TEST<br />This is the 3-character MMP number of the test MAGEC Control Program, it is set to 670 and should be left that way unless you are directed otherwise by the MAGEC support personnel.<br />## <br />CPMOD-PROD<br />This is the 3-character MMP number of the production MAGEC Control Program, it is set to 699 and should be left that way unless you are directed otherwise by the MAGEC support personnel.<br />## <br />DKE-LIMIT<br />This is a parameter which controls the size of the internal tables which hold the Data Class, Key, and Element definitions. This parameter is not currently implemented and is for future use.<br />## <br />ERROR-ATTRIBUTE<br />This parameter sets the type of error highlighting to be used for error fields at 7-color terminals. The only valid values are 1 (blink), 2 (reverse video), and 4 (underline). Blink is the default.<br />## <br />FCD-LIMIT<br />This parameter sets the maximum number of function codes for the system. It controls the size of an internal table. It (cont.)<br />is set to 6000, the default setting. This parameter is not yet implemented and should be left at 6000 for documentation (cont.)<br />purposes.<br />## <br /><br />next: install06.md.txt