4-5 REVERSE TABLE COMPILER

The Reverse Table Compiler is an <I> processor tool that allows the user to convert binary data files (*.DAT) retrieved from Mark V panel EEPROM memory into source files (.SRC). Using an ASCII text editor, these files can be read and if

necessary, altered.

NOTE

Comments included in EEPROM source files are lost when the file is compiled to be downloaded. Files received from EEPROM memory and converted to a .SRC format through the Reverse Table Compiler are also without comments.

4-5.1. Executing Reverse Table Compiler

Executing the Reverse Table Compiler requires Maintenance level password enabling. The program can be executed from a menu pick in the Main Menu or from the DOS prompt, type REVX_TAB. In both procedures the Help screen in Figure 4- 28 is displayed.

REVX_TAB: Reverse table compiler for Mark V EEPROM. V1.1 Command format:

REVX_TAB <table> <table> <table> ... <table> /SCALE=<scalefile> Where <table> can be "ALL", or any of the following data tables:

CONST - Contains control constants data. HIST - Contains point data for history log. EPA - Contains point data for EPA log.

MAOUT - Contains point data for 4-20 mA outputs. EVENT - Contains point data for events.

CHNG - Contains point data for change detection.

BOI - Contains point data for backup operator interface. TOTT - Contains point data for totalized data.

CBLR - Contains point data for cable remote.

Where /SCALE=<scalefile> is optional and will default if omitted to file "ENGLISH.SCA" for scaling information.

No spaces are permitted in the string "/SCALE=<scalefile>". Example: REVX_TAB CONST EPA CBLR /SCALE=METRIC.SCA

Figure 4-28. Help Screen

Use the format specified in the Help screen to convert uploaded EEPROM data. Type REVX_TAB followed by one or more

of the listed table definitions, CONST, HIST, EPA, MAOUT, EVENT, and so on.

The final parameter to be entered is the scaling information. Select one of the four available scaling options, ENGLISH, METRIC, CUSTOM, or HARDWARE. Omitting the scaling option causes the program to default to the English scale type when converting the EEPROM data file (see Figure 4-28). When the program has completed the conversion process, it displays the following message:

<*.SRC> Building <#> entries from filename <"filename"> REVX_TAB processing complete

If the program was unable to locate the EEPROM data file to execute the conversion, the following warning is displayed:

Inserting a scale command in the REVX_TAB command line that has no corresponding scale file (*.SCA) causes the following error message:

<filename> ERROR: Unable to read scale data file <file.SCA>

4-6. MK5MAKE.BAT

Any time changes are made to any of the assignment files, the source Table Files, or the CSP segment source files, the changes must be incorporated into the files which will ultimately be downloaded to the Mark V control panel. Several programs must usually be manually executed in a specific order from the DOS command line of the unit-specific directory. Some have the names of files or options specified on the command line in order for the changes to become effective.

MK5MAKE.BAT is a batch file which automatically executes those programs in succession with the proper filenames and options.

MK5MAKE.BAT must be executed in the unit-specific directory as it uses and creates files in the unit-specific directory, and uses files in the unit-specific PROM subdirectory. The flow-chart in Figure 4-30 illustrates the programs executed by

MK5MAKE.BAT.

4-6.1. OPERATION

When run from the DOS command line of the unit-specific directory, MK5MAKE.BAT first executes the program

DDLOCATE.EXE and specifies four assignment files to be used by DDLOCATE; IO.ASG, FACTORY.ASG,

ALLOCSSP.ASG, and SITE.ASG. DDLOCATE uses the specified assignment files, the ENGLISH.SCA scale code file, and accesses three files in the PROM subdirectory in order to create a new unsorted, un-validity-checked

UNITDATA.DAT file. Any messages generated by DDLOCATE are reported to the screen and written to a log file,

MK5MAKE.LOG. This log file, which contains any messages generated by the programs executed by MK5MAKE.BAT can be viewed using any ASCII text editor and printed, if necesssary.

Next, MK5MAKE.BAT executes the program DDUTIL.EXE with the sort option specified. DDUTIL sorts the

UNITDATA.DAT file and validity-checks it to determine if the same CDB pointname has been used for more than one CDB memory location/point. It writes the results of the sorting into a new UNITDATA.DAT file. Any error or warning messages generated as a result of the sorting and validity-checking are reported to the screen and written to MK5MAKE.LOG.

Creates Alarm Cross-Reference file ALARM.LST ALARM_L Program messages written to MK5MAKE.LOG ENGLISH.SCA Compiled CSP Segments Compiles all

source Table Files Creates sorted, validity-checked UNITDATA.DAT Creates unsorted, un-validity-checked UNITDATA.DAT PROM\UNITMAP.TPL PROM\UNITFREE.TPL PROM\UNITDATA.TPL No response in 30 seconds? NO YES COMPLETE COMP_SEQ Compile Control Sequence Program? TABLE_C ALL DDUTIL SORT DDLOCATE IO.ASG FACTORY.ASG ALLOCSSP.ASG SITE.ASG MK5MAKE.BAT

MK5MAKE.BAT then executes the Table Compiler program, TABLE_C.EXE with the ALL option specified on the command line. The ALL option directs the Table Compiler to compile (convert from ASCII text hexadecimal) all the source

Table Files (BOI_?.SRC, CBLR_?.SRC, CHNG_?.SRC, CONST_?.SRC, EPA_?.SRC, EVENT_?.SRC,

HIST_?.SRC, MAOUT_?.SRC, TOTT_?.SRC). Any messages generated as a result of compiling the Table files are reported to the screen, and also written to the log file, MK5MAKE.LOG.

Next, MK5MAKE.BAT executes ALARM_L.EXE. This program generates the Alarm Cross-Reference List, ALARM.LST,

from the UNITDATA.DAT and the alarm text message file, ALARM.DAT. Any messages generated as a result of running

ALARM_L is reported to the screen and written to MK5MAKE.LOG.

Finally, MK5MAKE.BAT asks the user if he/she wishes to compile the Control Sequence Program segment source files. The user has thirty seconds to respond. If no response is detected within thirty seconds MK5MAKE executes the CSP Compiler. If the user responds affirmatively to the prompt within thirty seconds by pressing " Y ", MK5MAKE executes the CSP Compiler and creates the downloadable hex format CSP files from the source CSP segment files. Any messages generated as a result of compiling the CSP is reported to the screen and written to MK5MAKE.LOG. If the user responds negatively to the prompt within thirty seconds by pressing " N ", MK5MAKE does not execute the CSP. If the user responds negatively, a message is reported to the screen and written to the log file indicating that the user elected not to compile the CSP. If no response is detected in thirty seconds, MK5MAKE executes the CSP Compiler, and a message indicating the CSP Compiler was

automatically executed along with any messages generated as a result of running the compiler is written to MK5MAKE.LOG. It is also reported to the screen.

4-6.2. MK5MAKE.LOG File

The log file, MK5MAKE.LOG, is created each time MK5MAKE.BAT is executed. As detailed in section 4-6.1, any messages generated by the programs executed when MK5MAKE is executed, are reported to the screen and written to the log file for later viewing and/or printing. This file can be very useful in troubleshooting and resolving warning or error messages generated by the execution of programs by MK5MAKE. It can be viewed using any ASCII text editor and printed the same as any ASCII text file.

4-7. Alarm Help

Alarm Help is a program to display context sensitive help screens for diagnostic and process alarms. It displays the correct section of contents from ASCII text files for a specific alarm. The files and their type of alarm is listed below.

File in the F:\UNITn directory is the Help text file for this type of alarm

HELP_QP.DAT <R>, <S>, and <T> cores’ process alarms

HELP_BP.DAT <C> and optional <D> cores’ process alarms

HELP_QD.DAT <R>, <S>, and <T> cores’ diagnostic alarms

HELP_BD.DAT <C> and optional <D> cores’ diagnostic alarms

The process alarm files (HELP_QP.DAT and HELP_BP.DAT) can be edited and printed for a specific application using any ASCII text editor. The diagnostic alarm files (HELP_QD.DAT and HELP_BD.DAT) are created by GEDS and should not be edited.