Program package GAMKED - Editing Gamma-11 macros PROGRAM PACKAGE GAMKED Original programs by Heinemann, Germany Enhancements by Antti Virjo Central University Hospital of Tampere SF-33520 Tampere 52, Finland 01-DEC-1982 1.0 PURPOSE ------- The program package GAMKED makes it possible to edit Gamma-11 macros with 'ordinary' RT-11 editors, e.g. KED, EDIT, TECO, or VTECO. This is accomplished by programs that first transform the macro to a tem- porary RT-11 ASCII file, which is edited normally, and then transform the RT file back to Gamma-11 macro form. This process is made auto- matic by an indirect command file, which can be started from Gamma or RT-11. 2.0 FEATURES -------- The following enhancements have been made to the original GAMKED pro- gram package made by Heinemann, and distributed by DECUS. 1. Editing is now possible also with 'ordinary' editors, e.g. EDIT, TECO, or VTECO. 2. In the original version exiting from KED with QUIT destroyed the contents of the original Gamma-11 macro without warning (macro was left empty). This is not the case anymore. 3. The program does not stop for illegal macro names, but gives an error message and asks for a new name. 4. The system allows creation of new Gamma-11 macros. 5. The system does not return automatically to Gamma, which is slow. Instead the system allows rapid successive editing of up to 70 Gamma macros. When this process is stopped, the system stays in RT-11. 3.0 EDITORS 'EDIT', 'TECO', AND 'VTECO' ------- ------- ------- --- ------- The editors TECO, VTECO, and EDIT can be used without patching the RT monitor. In background the VTECO editor is very convenient, because it can be run concurrently with FGAMMA, and one has a real time window on the VSV-01 monitor. Although this window shows only capital letters, VTECO can be used to edit small letters by setting in VTECO the ap- propriate terminal mode flag (e.g. 4ET$$ for a printer terminal). Program package GAMKED - Editing Gamma-11 macros PAGE 2 For selection between these 3 editors, see the installation instruc- tions below. 3.1 Usage: ------ As a Gamma-11 command type EDIT or as an RT command (if you are in RT) type @GEDIT. As answer to the console prompt GAMMA-11 macro to be edited (without .GMC extension)? give the name of the Gamma-11 macro in question using at most 10 characters. The macro to be edited can reside on another disk than the system disk, so that e.g. DL1:RENFLO is a valid answer. After editing the macro in the usual way, exit from the editor in the normal way using EX$$ or $$ commands ($$ leaves the original macro unchanged), and the system returns to RT. To return to Gamma, type R BGAMMA. If the macro to be edited is not found, the system asks: *** GAMMA-11 macro XXX.GMC does not exist. Do you want it to be created (N)? A positive answer (Y) creates the macro and gives control to the editor with an empty buffer. If you do not want to create the macro in question, answer with just , and the system asks for a new macro name. When editing the macro keep in mind, that the maximum number of lines is 10, and the maximum number of characters on a line is 49. If ei- ther limit is violated, a descriptive warning message is given on the console terminal, and the extra lines/characters are discarded. 3.2 Installation ------------ The following files must be on the system disk: EDIT.GMC EDIT.COM GEDIT.COM GAMKED.SAV GAMKE1.SAV As with KED editor, the files GAMKE1.TMP and GAMKE1.COM are created each time, if they do not exist on the system disk. Program package GAMKED - Editing Gamma-11 macros PAGE 3 If the RT command SET EDIT EDIT is in effect, the usual editor 'EDIT' is invoked. This is the default mode in RT. To automatically invoke TECO, the RT command SET EDIT TECO must have been given before entering Gamma macro editing. If often used, it is advisable to include this SET command in the startup file GMUSER.COM, so that the EDIT/TECO editing mode is preserved also when booting the system. VTECO, in turn, is invoked if the TECO editing mode is in effect, and the file VTECO.SAV is renamed to TECO.SAV and included on the system disk. 4.0 EDITOR 'KED' OR 'K52' ------ ----- -- ----- 4.1 Usage: ------ As a Gamma-11 command type KED or as an RT command (if you are in RT) type @GKED and continue as above with the 'ordinary' editors. After editing the macro in the usual way, exit from KED using the EXIT or QUIT commands (QUIT leaves the original macro unchanged), and continue as above. 4.2 Installation ------------ The following files must be on the system disk: KED.GMC KED.COM GKED.COM GAMKED.SAV GAMKE1.SAV The files GAMKE1.TMP and GAMKE1.COM are created each time, if they do not exist on the system disk. If you want to use K52 instead of KED, you should change in KED.COM the line 'RU KED' to 'RU K52' and maybe rename the macro KED.GMC to K52.GMC - in this latter case the Gamma command above changes to K52. Program package GAMKED - Editing Gamma-11 macros PAGE 4 5.0 COMPILING THE NECESSARY PROGRAMS FROM SOURCES --------- --- --------- -------- ---- ------- To compile the programs GAMKED.SAV or GAMKE1.SAV from sources, assign the source disk to INP, the output disk to OUP (INP and OUP can be the same), and start the command files GAMKED.COM or GAMKE1.COM by typing @INP:GAMKED or @INP:GAMKE1 Before this process, be sure that the disk INP contains the following files: GAMKED.COM GAMKED.FOR GAMKE1.COM GAMKE1.FOR ANS.OBJ RADCO.OBJ All those above files not written by the author originate from Tho- raxcenter, Erasmus University, Rotterdam, Holland, and have been in- cluded in programs distributed by DECUS. 5.1 Contents of the distribution kit -------- -- --- ------------ --- The kit includes the following files: GCKCOP.COM !Copies all files for GAMKED and CURKED ! from INP: to OUP: GAMKED.DOC !This file GAMKED.RNO !RUNOFF source file GAMKED.CRN !RUNOFF command file GAMKED.FOR GAMKED.COM GAMKED.SAV GAMKE1.SAV GAMKE1.FOR GAMKE1.COM GAMINF.RNO GAMINF.DOC !An abstract for the package GAMINF.CRN ANS.FOR ANS.OBJ RADCO.FOR RADCO.OBJ EDIT.GMC EDIT.COM GEDIT.COM GKED.COM KED.GMC KED.COM VTECO.SAV !TECO for VSV-01 video display STECO.SAV !TECO for VTV-01 storage scope display VTECO.DOC !Documentation for VTECO and STECO VTECO.SAV and STECO.SAV are unsupported software from the Gamma-11 V2.4 distribution disk. They should work also with Gamma-11 V3.1 and RT-11 V4.0 (at least VTECO does).