Configuring Typical CP/M Programs ================================= This appendix describes the installation procedures for a number of common commercial CP/M programs. The purpose of the installation is to configure the program to the screen handling control codes within HUNTER. The control codes used by the HUNTER screen are. ================= ====================== Function Code (Hex) ================= ====================== Clear Screen 01 Home Cursor 02 Cursor Addressing 0F, x co-ord, y co-ord Cursor Right 0C Cursor Left 08 Cursor up 0B Cursor down 0A ================= ====================== The installation procedure is generally carried out on a standard CP/M desk-top machine prior to downloading information, see :doc:`../file-manager/loading-files`. MBASIC ------ Standard disk-based Microsoft Basic can be down-loaded into HUNTER with no installation or modification. The only file to transfer is MBASIC.COM. MBASIC may now be run. Wordstar Version 2 ------------------ The standard disk from MicroPro has the following files: - INSTALL.COM - WSU.COM - WSMSGS.OVR - WSOVLY1.OVR The INSTALL program is used to configure the main Wordstar program WSU.COM or an existing Wordstar file (WS.COM). The two overlay files, WSMSGS.OVR and WSOVLY1.OVR, do not need any alteration. When using the INSTALL program, refer to the Wordstar manual for further information - INSTALL is fairly self explanatory. The main features of the procedure are explained below: #. Type INSTALL to load and run INSTALL on your desk-top unit. #. Select the appropriate Wordstar file, e.g. WSU.COM. #. Terminal MENU: select "Z" for "none of the above." This will be described later when patching in the exact controls. #. Printer MENU: select you own type of printer - typically, selection "A" will be compatible with most types of printer. #. Communications Protocol MENU: select "N", this will enable HUNTER's own communications package to handle any necessary protocol. #. Driver MENU: select "L" for the standard CP/M list device. #. You are now prompted for: ARE MODIFICATIONS TO WORDSTAR NOW COMPLETE?: Answer "N" for No, as it is now necessary to patch the codes for the terminal selection. INSTALL will prompt with: LOCATION TO BE CHANGED (0=END):0248 ADDRESS:0248H OLD VALUE:00H NEW VALUE:18 In the above example, location 0248 was entered and the New Value 18H entered. This procedure should be repeated for the following locations: ============== =============== ============================ Location (Hex) New Value (Hex) Function ============== =============== ============================ 0248 18 Screen Height (24 lines) 0249 50 Screen width (80 characters) 024A 01 Clear screen 024B 0F Cursor positioning 0253 00 " 0258 00 " 025D FF " 025E 00 " 025F 00 " 0260 00 " 0264 00 " 02AA 00 Inhibit scrolling ============== =============== ============================ After engineering these patches, terminate the procedure by entering 0 when the next location is requested. After confirming the selections and exting from INSTALL, the three files: - WS.COM - WSMSGS.OVR - WS0VLY1.OVR are ready to be loaded and run, see :doc:`../file-manager/loading-files` for details of the procedure. SuperCalc Version 1 ------------------- The standard disk from Sorcim has the following files. - INSTALL.COM - SC.COM - SC.OVL - SC.HLP The INSTALL program is used to configure the main program SC.COM. The two other files SC.OVL and SC.HLP do not need any alteration. It will be helpful to refer to the SuperCalc manual when using INSTALL. However, below is set out the response to each menu choice to install for the HUNTER, after running the "INSTALL.COM" program. Terminal Selection Menu ~~~~~~~~~~~~~~~~~~~~~~~ No automatic installation is provided for HUNTER. Type in 'x' (not specified on the screen) for manually setting up the various options. A second menu is displayed showing options A-F. Each option should be configured as described. A. EDIT SCREEN CONTROLS ^^^^^^^^^^^^^^^^^^^^^^^ Another menu is displayed. Choose each option in turn and modify as prompted until the following is displayed: #. ClearScreen : 1,01 #. Clear to EOL : Unconfigured #. Home cursor : Unconfigured Return to the main selection and run by pressing x. dBase II -------- The well known data base package, dBASE II, can be installed to run on the HUNTER. Described below is the sequence of to the install program to give full functions to the software package. The version described is V2.3B, which is supplied as 13 individual files. They are: - DBASE.COM - DBASEMSG.COM - DBASEMAI.OVR - DBASEAPP.OVR - DBASEBRO.OVR - DBASEJOI.OVR - DBASEMOD.OVR - DBASEMSC.OVR - DBASERPG.OVR - DBASESRT.OVR - DBASETTL.OVR - DBASEUPD.OVR - INSTALL.COM The first three files are vital to any dBASE program, but the rest are separate overlay files each supporting a particular function. For example, if a sort facility is required, then the DBASESRT.OVR file will be required on the HUNTER. Installing dBASE ~~~~~~~~~~~~~~~~ On your host CP/M machine, type: :: INSTALL to run the install program. The first question will ask whether you require full screen operations. Type 'Y' A menu of different types of VDU will then appear. Select 'Z' for user supplied terminal commands. The next question refers to the type of data to be entered. All data will be in hex, so answer accordingly. #. DELETE A CHARACTER SEQUENCE The correct sequence is 03,00,20 #. DIRECT CURSOR POSITIONAL SEQUENCE | Column number position = 02 | Line number position = 03 | Constant bias = 00 | The skeleton is 0F, 00, 00 #. CLEAR AND HOME SCREEN COMMANDS 01 #. BRIGHT/STD VIDEO COMMANDS None #. DIM/REVERSE VIDEO COMMANDS None #. INITIALISATION SEQUENCE None #. EXIT SEQUENCE 01 #. RESET TO STANDARD VIDEO MODE None #. ALTER SCREEN SIZE | Screen width = 40 | Number of lines = 08 Completion of Installation ^^^^^^^^^^^^^^^^^^^^^^^^^^ To complete installing, default the macro character to "&" and key-in a space for no error dialogue. The CP/M operating system is version 2. 2. , therefore: Enter "A" to complete the installation. The above files are now ready for installation.