Catalyst was an essential utility for the Apple III system that allowed users to install programs onto their Profile hard disks. Installation and configuration of Catalyst is tricky so the User's Manual is reproduced below. The Program disk of the Catalyst installation set is copy protected and I am informed that it can't be copied using standard tools such as Copy II+. The Data disk is not copy protected. Catalyst User's Manual Copyright 1982 Quark Engineering Quark Incorporated 2525 West Evans, Suite 220, Denver, CO 80219, USA (303) 934-2211 Quark Incorporated LIMITED WARRANTY Quark Engineering warrants this product against defects in materials and workmanship for a period of 90 days from the original date of purchase to the original purchaser only. The warranty is valid only if the Warranty Registration card is returned to Quark. Also, no warranty coverage will be provided in the event that the product has been used prior to its sale to the original purchaser. During the warranty period, Quark will repair or replace (at its option) at no charge any components that prove to be defective, provided the defective component is returned (shipping prepaid and properly packed) to Quark Engineering. Proof of purchase date must accompany any request for warranty service. This warranty does not apply if, in the opinion of Quark, the product has been damaged by accident, misuse, neglect or subjected to modifications other than those prescribed in this manual. This warranty is in lieu of all other express or implied warranties, statements or representations. All implied warranties, including those of merchantability or fitness for a particular purpose, are also limited to a 90 day duration from date of original purchase. Some states do not allow limitations on how long an implied warranty lasts, so the above limitation may not apply to you. In the event that this product should prove defective, your sole remedy shall be the repair or replacement of the defective components as stated above. Quark will not be liable for any incidental or consequential damages arising from use of this product. Some states do not allow the exclusion of incidental or consequential damages, so the above limitation may not apply to you. This warranty gives you specific legal rights and you may have other rights which vary from state to state. The following notice is required by Apple Computer, Inc. It applies only to the software components actually produced by Apple. All other software is covered by our limited warranty. APPLE COMPUTER, INC. MAKES NO WARRANTIES, EITHER EXPRESS OR IMPLIED, REGARDING THE ENCLOSED COMPUTER SOFTWARE PACKAGE, ITS MERCHANTABILITY OR ITS FITNESS FOR ANY PARTICULAR PURPOSE. IMPORTANT Before attempting to use Catalyst, read the entire contents of chapter 1. This chapter covers the provisions of your warranty and provides general information on Catalyst. Catalyst makes irreversible modifications to certain programs (such as VisiCalc and Word Juggler) during installation. These modifications are made to insure that the manufacturer's intent in copy protecting their programs is preserved. If you do not have a good concept of the way Catalyst handles these protected interpreters, you may find yourself unable to use your programs as planned. Read carefully the sections of chapter 1 concerned with copy protected programs. Many of the procedures described in this manual are fairly complex. If you are at all uncomfortable with any of the procedures, do not attempt them yourself. Ask your dealer for assistance with the installation. Quark is not responsible for damage caused by improper use of the Catalyst program. Quark can not replace any programs which have been damaged other than the Catalyst program itself. Quark Program License Agreement YOU SHOULD CAREFULLY READ THE FOLLOWING TERMS AND CONDITIONS BEFORE USING THIS PRODUCT. USE OF THIS PRODUCT INDICATES YOUR ACCEPTANCE OF THESE TERMS AND CONDITIONS. IF YOU DO NOT AGREE WITH THEM, YOU SHOULD PROMPTLY RETURN THE PRODUCT; AND YOUR MONEY WILL BE REFUNDED. Quark provides th1s program and licenses its use in the United States and abroad. You assume responsibility for the selection of the program to achieve your intended results, and for the installation, use and results obtained from the program. LICENSE You may: a. use the program on a single machine; b. copy the program into any machine readable or printed form for backup purposes In support of your use of the program on the single machine (Certain programs, however, may include mechanisms to limit or inhibit copying); and c. transfer the program and license to another party if the other party agrees to accept the terms and conditions of this Agreement. If you transfer the program, you must at the same time either transfer all copies whether in printed or machine-readable form to the same party or destroy any copies not transferred; this includes all modifications and portions of the program contained or merged into other programs. You must reproduce and include the copyright notice on any copy, or portion merged into another program. YOU MAY NOT USE, COPY, OR TRANSFER THE PROGRAM, OR ANY COPY, IN WHOLE OR IN PART, EXCEPT AS EXPRESSLY PROVIDED FOR IN THIS LICENSE. ANY USE OF ANY COPY OF THE PROGRAM NOT SPECIFICALLY PROVIDED FOR IN THIS LICENSE AUTOMATICALLY TERMINATES YOUR LICENSE. The license is effective until terminated. You may terminate it at any other time by destroying the program together with all copies. It will also terminate upon conditions set forth elsewhere in this Agreement. You agree upon such termination to destroy the program together with all copies. LIMITED WARRANTY The Limited Warranty for this product is included elsewhere In the manual for this product. It taken together with this agreement constitutes the whole of the responsibilities of Quark and the purchaser of this product. GENERAL You may not sublicense, assign or transfer the license of the program except as expressly provided In this agreement. Any attempt otherwise to sublicense, assign or transfer any of the rights duties or obligations hereunder is void. This Agreement will be governed by the laws of the State of Colorado. Should you have any question concerning this Agreement, you may contact Quark by writing to Quark Incorporated, 2525 West Evans, Suite 220, Denver, CO, 80219. YOU ACKNOWLEDGE THAT YOU HAVE READ THIS AGEEEMENT, UNDERSTAND IT AND AGREE TO BE BOUND BY ITS TERMS AND CONDITIONS, YOU FURTHER AGREE THAT IT IS THE OOFPLETE AND EXCLUSIVE STATENENT OF THE AGREEMENT BETWEEN US WHICH SUPERCEDES ANY PROPOSAL OR PRIOR AGREEMENT, ORAL OR WRITTEN AND ANY OTHER COMMUNICATIONS BETWEEN US RELATING TO THE SUBJECT MATTER OF THIS AGREEMENT. TABLE OF CONTENTS CHAPTER 1 - INTRODUCTION OVERVIEW REPAIR AND REPLACEMENT SHIPPING DISKETTES SOFTWARE UPDATES COMMENTS AND SUGGESTIONS CHAPTER 2 - INSTALLATION CONFIGURING CATALYST TO GO WITH YOUR HARDWARE INSTALLING PROGRAMS ON YOUR HARD DISK INITIAL SETUP INSTALLING INTERPRETERS INSTALLING WORD JUGGLER INSTALLING VISICALC. INSTALLING VISICALC (ADVANCED VERSION) INSTALLING PASCAL INSTALLING COBOL INSTALLING BASIC INSTALLING APPLE WRITER /// INSTALLING PROGRAMS INSTALLING MAIL LIST MANAGER INSTALLING QUICKFILE INSTALLING MISCELLANEOUS BASIC PROGRAMS INSTALLING MISCELLANEOUS PASCAL PROGRAMS INSTALLING THE SPOOLER FINISHED AT LAST SETTING UP YOUR BACKUP CATALYST DISK BACKING UP YOUR HARD DISK CHAPTER 3 - USING CATALYST STARTING CATALYST CHANGING PROGRAMS THE SYSTEM REBOOT PROGRAM MORE ON THE CATALYST EDITOR ADDING MENU ENTRIES EDITING MENU ENTRIES DELETING MENU ENTRIES SELECTING A STARTUP PROGRAM CONTROLLING THE DATE AND TIME REQUEST UPDATING THE INTERPS FILE CHAPTER 4 - ADVANCED INFORMATION USING THE BASIC STARTUP PROGRAM USING THE PASCAL STARTUP PROGRAM PROGRAMMING CONSIDERATIONS APPENDICES APPENDIX A - ERRORS & RECOVERY ERRORS DURING INITIAL BOOTUP ERRORS IN THE CATALYST MAIN MENU ERRORS IN THE CATALYST EDITOR ERRORS IN THE BASIC STARTUP PROGRAM ERRORS IN THE PASCAL STARTUP PROGRAM APPENDIX B - DRIVER CONFIGURATION BLOCKS CONFIGURATION BLOCK FOR QUARK'S .CONSOLE DRIVER CONFIGURATION BLOCK FOR QUARK'S .PRINTER DRIVERS CONFIGURATION BLOCK FOR THE .CATALYST DRIVER SETTING UP CATALYST FOR DIFFERENT HARD DISKS APPENDIX C - FILE FORMATS FORMAT OF THE 'INTERPS' FILE FORMAT OF THE BASIC AND PASCAL MENU FILES Discourse, Catalyst and Word Juggler are trademarks of Quark Engineering. Apple is a registered trademark of Apple Computer, Inc. PFS is a trademark of Software Publishing Corporation. VisiCalc is a registered trademark of VisiCorp. CHAPTER 1 INTRODUCTION When you purchased Catalyst you should have received the following: 1) This Catalyst manual 2) A diskette labeled "Catalyst" 3) A diskette labeled "Catalyst Backup" 4) A diskette labeled "Catalyst Data" 5) A Warranty Registration card If your Catalyst does not contain all these things, return it to your dealer. Do NOT use an incomplete Catalyst!!! IMPORTANT: You must fill out and return the Warranty Registration Card. If you do not, no warranty service of any kind can be given. This card is the only mechanism we have of providing warranty service and of informing you about updates to Catalyst, new products and improved versions of Catalyst. WARNING: Your Catalyst disks are very special. Lost disks cannot be replaced. In the event that a disk is damaged, it must be returned to Quark for repair (see REPAIR AND REPLACEMENT). Under no circumstances will a replacement disk be supplied unless a damaged Catalyst disk is returned. Extra disks with the same serial number cannot be obtained for any reason. OVERVIEW Catalyst allows you to put many of the programs which you must normally boot on the hard disk. Word Juggler, BASIC, Pascal and VisiCalc (among others) may all be put on the hard disk. Once Catalyst has been installed and the programs have been put on the hard disk, the only disk you may ever have to use is the Catalyst disk. The kinds of programs that Catalyst allows you to put on the hard disk are called "interpreters". BASIC, Pascal, VisiCalc, Word Juggler and Apple Writer /// are the most common examples of such programs. Programs such as System Utilities, Mail List Manager and PFS are not interpreters. These particular programs are written in the Pascal language. You may still put them on the hard disk, but a more complicated procedure is required. And, in some cases, they are copy protected and may require a special procedure to activate them. Certain programs such as Word Juggler and VisiCalc are "copy protected". These programs may also be put on your hard disk. However, Catalyst will permanently lock these disks to itself. The original disks will no longer be bootable. They will also not be copyable by any other Catalyst. In the case of such copy protected interpreters, you are generally given two copies of the disk, a master and a backup (if a backup is available at extra cost, we suggest that you purchase it). If the disks are not labeled master and backup, select one arbitrarily and label it backup. You may use Catalyst to copy the backup to your hard disk. This disk will become the source you use to regenerate the interpreter on your hard disk should such ever be required. Since it cannot be booted after being copied to the hard disk, you should put it somewhere for safekeeping. The master disk will still be bootable. It will serve as your last bastion of defense should your hard disk die. You will still be able to boot it directly. When Catalyst starts up it will ask you for the date and time if it has been told to do so. Then it will present a menu of programs (from 1 to 30 of them). You merely enter the number of the program you want to use and press RETURN. That program will be started for you. To switch to another program, you simply QUIT from the program you are using. You will be returned to the main Catalyst menu. In some cases, you can also exit to the Catalyst menu by holding down both apple keys and pressing ESCAPE. You may then select a different program. Catalyst will reload only the program and its interpreter. It will not reload the SOS operating system or any of the drivers. The partial loading procedure used by Catalyst has several consequences. First, all drivers that will ever be needed by any interpreter must always be present. This means that certain programs will have less memory than normal. For example, VisiCalc certainly does not require the .GRAFIX driver, but if you are using Business Graphics, it will have to be loaded anyway. Second, space must be reserved for the largest interpreter. This is probably the biggest cause of loss of space. (Some of this space may still be used for other things, such as file buffers.) There are several benefits that are gained by the partial loading procedure. The chief is, of course, speed. Another benefit is that if you are using the Discourse spooler, you may switch from program to program without interrupting spooler operation. Thus, you can have reports spooled from, say, VisiCalc and be editing a Word Juggler document. There are three main parts to Catalyst. The first part is the interpreter that starts up the system and asks for the date and time if appropriate. The second part is a special interpreter that allows you to copy interpreters to the hard disk and edit some Catalyst parameters. The third part is the 8K Catalyst driver which displays the menu of programs and allows you to switch from one program to another. REPAIR AND REPLACEMENT The first page of this manual is your LIMITED WARRANTY. Read it carefully. Basically it says this: If within 90 days of purchase, your Catalyst diskette fails to function properly through some error on our part, we will "repair" or replace it at our option. It should be returned to us postpaid and properly packed (see below) along with the following: 1) Proof of purchase and purchase date 2) A description of the problem (and whose fault you think it is) 3) A description of the system on which the program is being used (Amount of memory, peripherals attached, cards installed, etc.) 4) Your Warranty card (if you haven't already sent it in) This warranty applies only to the original purchaser, and does not apply to any product which has been used prior to its sale by any dealer or distributor. In the event that we have received no Warranty Registration card, no warranty service will be provided. After the 90 day period (or in the event that the failure is not our fault), the diskette will be recopied, if returned postpaid for a charge of $10. If the diskette must be replaced, the charge will be $20. Enclose $10 with your disk to avoid C.O.D. and shipping charges. If your disk must be replaced, you will be billed C.O.D. for any unpaid charges. You cannot obtain a replacement diskette without returning the original Catalyst disk. SHIPPING DISKETTES When mailing a diskette, do not just put it in an envelope. Not even a padded envelope. The post awful has a tendency to bend things. This generally destroys diskettes. You should sandwich the diskette between two pieces of corrugated cardboard and then put it in an envelope. Write the magic incantation "DO NOT BEND" on both sides of the envelope in some color that stands out. Alternatively, you may purchase special diskette mailers from your local dealer, such as the ALF Products Floppy mailer or Floppy Armour. SOFTWARE UPDATES Fill out and mail in the Warranty Registration card supplied with Catalyst. If it becomes necessary for Quark to provide a corrected version of your software, you will receive a letter stating the errors that are being fixed and any new features which you may get as a side effect. You may then send in your diskette and the new software will be returned to you. This card will also put you on our mailing list for new products and upgrades to Catalyst. COMMENTS AND SUGGESTIONS If you have suggestions for changes or improvements in the current product, or suggestions for a new product, just drop us a line. Your comments are always welcome. CHAPTER 2 INSTALLATION The installation procedures described in this chapter are intended to be used by those who do not require a detailed understanding of Catalyst and its interaction with the Apple ///. These procedures were selected because they are the simplest possible and not because they use the full power of Catalyst. Initially even the sophisticated user should follow these procedures to the letter. Modifications can always be made at a later date. Catalyst installation is a difficult operation. It involves fairly extensive use of the System Configuration Program (SCP) on Apple's System Utilities disk. Read it carefully before doing anything. If you are the least bit uncomfortable with any of the things it asks you to do, have your dealer perform the installation. Make sure you understand the purpose of each step before continuing to the next step. To perform these procedures you will need the System Utilities disk, your Catalyst disks and a disk which you commonly boot and use to produce printouts (such as VisiCalc or Word Juggler). You should also have a piece of paper and a writing implement handy. CONFIGURING CATALYST TO GO WITH YOUR HARDWARE The Catalyst disk as it first comes to you is not bootable. You must begin by configuring it to go with your system. Follow these instructions precisely. Do NOT assume that you know enough to skip ANY of these steps! The following discussion assumes that you are using a serial printer or a printer connected via Apple's Universal Parallel card. If you are using a printer connected with anyone else's parallel card, you will have to use a slightly different procedure. If you do not know if your printer is parallel or serial, you should not attempt this procedure. The first step is to determine the way your Apple /// and printer communicate. To do this you will be using the System Utilities disk to determine the contents of the Driver Configuration Block (DCB) for your printer (if you don't know what a DCB is don't panic, we'll get to it). If you are using a Silentype printer, you may skip these steps. 1) Boot the System Utilities disk. 2) When System Utilities has booted, press "S" to start the System Configuration Program (SCP). 3) Press "R" to Read a Driver File. 4) Put a disk containing a program you often use for printing in the internal disk drive. 5) Press RETURN to load the drivers from this disk. 6) When the drivers are loaded. Put the System Utilities disk back in the internal drive. 7) Press ESCAPE to return to the main SCP menu. 8) Press "E" to edit the drivers. 9) Use the up and down arrow keys to position the inverse bar over the driver that controls your printer (probably called .PRINTER or .QUME). Then press RETURN. 10) Press the up arrow key to position the inverse bar to option number 6 (Configuration Block Data) and then press RETURN. 11) The Driver Configuration block is displayed. Press the right arrow key a few times. Notice that a set of square brackets moves across a field of five 2-digit hexadecimal numbers. Record these numbers and label them as "PRINTER DCB". 12) Press ESCAPE three times to return to the SCP main menu. 13) Press "Q" to quit to the main System Utilities menu. You will be warned that no generate has been performed. Press "Y" to quit anyway. Now you must set up the Catalyst drivers. Do NOT copy another set of drivers onto the Catalyst disk. If you do, the Catalyst drivers will be lost and your Catalyst will have to be returned to Quark for repair. Disks which must be recopied because of failure to follow the proper installation procedures are not covered by your warranty. The set up procedure consists of selecting the appropriate set of drivers and setting up the DCB for your printer. Skeleton drivers are provided for both 128K and 256K machines. The only difference between these two sets of drivers is that the 256K set includes some additional drivers (such as .GRAFIX). 1) Boot the System Utilities disk (unless it has already been booted as part of the above procedure). 2) Press "F" for File handling commands. 3) Remove the write protect tab from the Catalyst disk and put it in the internal drive. 4) Press "R" for Rename files. 5) As the old name of the file enter: a) For a 128K machine, ".D1/DRIVERS.128". b) For a 256K machine, ".D1/DRIVERS.256". 6) As the new name for the file, enter ".D1/SOS.DRIVER". 7) After the file has been renamed, press ESCAPE. 8) Press "D" to delete a file. 9) As the name of the file to delete, enter: a) For a 128K machine, ".D1/DRIVERS.256". b) For a 256K machine, ".D1/DRIVERS.128". 10) Press "Y" to confirm the deletion. 11) Press ESCAPE twice to return to the main System Utilities menu. 12) Put the System Utilities disk back in the internal drive. 13) Press "S" for the System Configuration Program (SCP). 14) Press "R" to Read a driver file. 15) Put the Catalyst disk in the internal drive and press RETURN to load the drivers. 16) If you have a serial printer, skip to step 29. Special instructions for parallel printers: 17) You must now load your parallel driver. If you are using Apple's Universal Parallel card, a driver is provided. Use this driver in preference to the one supplied by Apple. If you are using another manufacturer's card, you will have to install their driver. 18) For Apple's Universal parallel card, enter ".D /PARALLEL.DRIVER". (For any other interface, you will have to swap disks and load the appropriate driver.) 19) Press ESCAPE after the driver has been loaded. 20) Put the System Utilities disk in the internal drive. 21) Press "D" to delete drivers. 22) Press up arrow twice to position the inverse bar over the old serial printer driver. 23) Press RETURN and then "Y" to delete the serial printer driver. 24) If your parallel card is installed in slot 1, go to step 29. 25) Press ESCAPE and then "C" to change system parameters. 26) Press down arrow and RETURN to select Peripheral slot assignments. 27) Press RETURN to select the printer driver and then enter the slot number of the parallel card. 28) Press ESCAPE. 29) Press ESCAPE to exit to the main SCP menu. 30) Install the System Utilities disk (if its not already installed) and press "E" to edit drivers. 31) Position the inverse bar over the printer driver and press RETURN. 32) Press up arrow once to position the inverse bar over option 6 (Configuration Block Data) and then press RETURN. 33) If the numbers that are displayed are not the same as the ones you wrote down under PRINTER DCB, change them. You do this by entering each number, and then pressing RETURN. The right arrow key is used to take you to the next number. 34) Press ESCAPE twice. 35) If you are using a ProFile which is not installed in slot 4 continue on to step 36. Otherwise, skip to step 43. 36) Use the up and down arrow keys to position the inverse bar over the .CATALYST driver, then press RETURN twice. 37) Enter the number of the slot containing your ProFile and then press RETURN. 38) Press ESCAPE three times. 39) Press "C" for Change system parameters. 40) Press "2" for change peripheral slot assignments. 41) Using the up and down arrow keys, position the inverse bar over the ProFile driver. Press RETURN and then enter the number of the slot containing the ProFile. 42) Press ESCAPE. 43) Press ESCAPE to return to the main SCP menu. 44) If you are not using a ProFile, you will want to delete the ProFile driver and add the driver for your hard disk now (see following note). You may wish to add or delete other drivers as well. Do NOT delete any of the following drivers: .AUDIO, .CONSOLE, .FMTD1, .CATALYST 45) From the main SCP menu, press "G" to generate a new system. 46) Put the Catalyst disk in the internal drive. 47) Press right arrow twice to position the cursor over the "2" in ".D2/SOS.DRIVER". 48) Press "1 " and then RETURN. 49) Press "Y" to confirm the deletion of the old file. 50) After the generation is complete, put the System Utilities disk in the internal drive. Press ESCAPE and then "Q" to return to the System Utilities main menu. Put a new write protect tab on your Catalyst disk. NOTE FOR SYSTEMS NOT USING PROFILE: Only certain disk drives are supported by Catalyst. To get Catalyst to use your disk drive, you will have to change the contents of the Catalyst DCB. The values that should be used for each different disk are given in Appendix B. If your drive is not listed, contact Quark for assistance. Catalyst is now set up to go with your hard disk and printer. Only two things remain to be done. You must move all your programs onto the hard disk, and you must set up the Catalyst main menu to list all those programs. INSTALLING PROGRAMS ON YOUR HARD DISK There are a number of programs that can be readily moved to your hard disk for use by Catalyst. Many of them are covered here. Other programs can also be moved. If a particular product is not mentioned here, you may wish to begin by contacting Quark. In most cases, however, a call to the manufacturer of the product will be required. INITIAL SETUP You should still have your System Utilities disk booted from the previous operation. You will now use this to do the initial setup of your hard disk for use by Catalyst. The following assumes you are using a ProFile. If you are not, you will have to enter the name of your hard disk device wherever ".PROFILE" appears in the following text. This procedure also moves the Pascal run time system to your hard disk. 1) Boot the System Utilities disk (if you haven't already). 2) Press "F" for File handling commands. 3) Press "C" to Copy files. 4) Put the Catalyst Data disk in the internal drive and then enter ".D1/SYSTEM.MISCINFO" as the source file name. 5) Enter ".PROFILE/SYSTEM.MISCINFO" as the destination file name. 6) After the copy is complete, enter ".D1/SYSTEM.PASCAL" as the next source file name. 7) Enter ".PROFILE/SYSTEM.PASCAL" as the destination file name. 8) After the copy is complete, press ESCAPE twice to return to the main menu. 9) If your hard disk is not a ProFile installed in slot 4, use the System Configuration Program to add the driver for the hard disk to the SOS.DRIVER file on the Catalyst Data disk. 10) Boot the Catalyst Data disk. 11) When you are asked if you want instructions, press "N". 12) When you are asked for the name of the NEW Pascal system device, enter ".PROFILE". 13) When you are asked for the name of the drive containing SOS.INTERP, enter ".D1 ". 14) When the move is successfully completed, you are returned to the Pascal command line. Boot the System Utilities disk when this happens. The next step is to copy the majority of the contents of the Cstalyst Data disk to your hard disk. The System Utilities program will also be put on the hard disk at this time. The next step is to copy the majority of the contents of the Catalyst Data disk to your hard disk. The System Utilities program will also be put on the hard disk at this time. 1) Boot the System Utilities disk (if it isn't already booted). 2) Press "F" for File handling commands. 3) Press "C" to copy files. 4) Insert the Catalyst Data disk in the internal drive. 5) Enter ".D1 /ROOT/=" as the name of the source file. 6) Enter ".PROFILE/=" as the name of the destination file. This will- copy several files. 7) Enter ".D1 /SOS.INTERP" when you are again asked for a source file name. 8) Enter ".PROFILE/CATALYST/PASCAL" when asked for the destination file name. 9) When the copy is complete, put the System Utilities disk back in the internal drive. 10) Enter ".D1 /SYSTEM.STARTUP" as the source file name. 11) Enter ".PROFILE/CATALYST/SYS.UTIL" as the destination file name. 12) After this file has been copied, press ESCAPE twice to return to the System Utilities main menu. Now its time to verify that the configuration was properly performed. 1) Boot your Catalyst disk. 2) Catalyst should display the date and time and ask you if it is correct. It probably isn't, so answer with "N" and RETURN. You will be asked for the correct date. Enter it. You will then be asked for the correct time. Enter it. You will be re-asked if the date and time are correct. Enter "Y". 3) A menu of programs will be displayed. DON'T SELECT ANY OF THEM YET. The next step is to install the interpreters on the hard disk. Interpreters are a special class of programs. The following pages detail the method used for installing interpreters. You may not own all these interpreters. If not, just skip to the next interpreter. After all interpreters have been installed, reboot the Catalyst disk. If you are using a 128K machine, it may not be possible to execute the System Utilities program via Catalyst. (If you get a stack overflow when trying to execute System Utilities, it is not possible to use System Utilities with Catalyst). In such a case, you will have to alternately boot the Catalyst disk and the System Utilities disk. INSTALLING INTERPRETERS INSTALLING WORD JUGGLER NOTE: Word Juggler is a copy protected program. Once you have installed it on your hard disk, the disk will no longer be bootable. Use your backup disk for this purpose. Once installation has been accomplished, put a label that says "Catalyst" on the backup disk. Put your backup away for safe keeping. The backup will not be bootable, but it may be copied to the hard disk again if the need ever arises. Your master disk will still be bootable and should only be used in case your hard disk breaks down. A Word Juggler with a version number of 2.4 or greater is required in order for it to be put on the hard disk. If you attempt this procedure on an earlier version of Word Juggler, Catalyst will refuse to make the transfer and inform you of the difficulty. Word Jugglers with version numbers prior to 2.4 may be updated for free to the latest version (in the 2.x series). Simply return your Word Juggler disk postage paid and properly packed to Quark Engineering and explain that you need a new version to use with Catalyst. Your disk will be updated and returned to you promptly by first class mail. READ THE SECTION ON SHIPPING DISKS IN ANY QUARK MANUAL BEFORE RETURNING A DISK TO QUARK. Word Juggler special considerations: Word Juggler accessories such as the Data File Merge program, Mail List Manager Interface and Lexicheck can also be put on the hard disk. If you have not done this, you may wish to follow the instructions for doing so in your Word Juggler (and Lexicheck) manual now. You should probably put all these goodies in a subdirectory called "WJ" which exists in the root directory of your hard disk. Make sure you can still boot Word Juggler and access the versions of these programs that reside on the hard disk before continuing. Copy procedure: 1) Boot your Catalyst disk (if you haven't already), set the date and time and go to the Catalyst main menu. 2) Enter the number for "Catalyst Edit". 3) Enter "6" to move Word Juggler to the hard disk. 4) You will be asked to put the disk containing the interpreter (Word Juggler) in the internal disk drive and press the space bar. Remove the write protect tab from your disk, insert the disk and press the space bar. 5) You will be asked for the hard disk pathname of the interpreter. Enter "CATALYST/WORD. JUGGLER" 6) Word Juggler will be copied to your hard disk. Put a new write protect tab on your Word Juggler disk. Adding Word Juggler to the Catalyst menu: 1) Enter "1" to add an entry to the Catalyst menu. 2) Enter "1 " to make Word Juggler the first entry in the menu. 3) You will be asked for the display name of this program. Enter "Word Juggler". 4) Enter "CATALYST/WORD.JUGGLER" when you are asked for the interpreter pathname. 5) Then you will be asked for the character set pathname. Just press RETURN (this accepts the default character set). 6) You will also be asked if the character set should be inverted. Press RETURN for noninverted. 7) Press RETURN again to use the default keyboard. 8) Press RETURN to use the default prefix. (This controls where Word Juggler gets some of its default files, not the initial setting of the Word Juggler prefix.) 9) Press RETURN to require a REBOOT or QUIT to exit Word Juggler. 10) Finally press RETURN for the program path question since Word Juggler does not use this feature of Catalyst. 11 a) You will be asked if this entry is correct. If it is, enter "Y", or just press RETURN. You will be allowed to insert another entry. Since you don't want to do this, enter "0" to exit to the main menu. 11 b) If you made any mistakes during entry, enter "N". You may then enter the number of the item you wish to correct. When all items are correct, enter "0". Then enter "0" again to exit to the main menu. 12) Enter "7" to update the INTERPS file. When you are asked if you want to recalculate the load address, enter "Y". (You will be required to install the Catalyst disk with the write protect tab removed and press space for this step.) 13) Press space when the update is complete. Exit to the Catalyst main menu by entering "0". Copying special Word Juggler files (use the files on your Word Juggler Master disk): 1) From the Catalyst main menu, select the System Utilities program. 2) Press "F" for File handling commands. 3) Press "C" for Copy files. 4) Put your Word Juggler disk in the internal disk drive. 5) Enter ".D1/WJ.PARAMS" as the name of the source file. 6) Enter ".PROFILE/WJ.PARAMS" for the name of the destination file. 7) If you are not using a special USER printer filter, go to step 10. 8) Enter ".D1/WJ.USER" as the name of the source file. 9) Enter ".PROFILE/WJ.USER" as the name of the destination file. 10) Once the files have been copied, hold down both apple keys and press ESCAPE to return to the Catalyst main menu. INSTALLING VISICALC NOTE:VisiCalc is a copy protected program. Once you have installed it on your hard disk, the disk will no longer be bootable. Label one of your two VisiCalc disks with "BACKUP". Use this backup disk when performing the installation procedure. Once installation has been accomplished, put a label that says "Catalyst" on the backup disk. Put your backup away for safe keeping. The backup will not be bootable, but it may be copied to the hard disk again if the need ever arises. Your master disk will still be bootable and should only be used in case your hard disk breaks down. Copy procedure: 1) Boot your Catalyst disk (if you haven't already), set the date and time and go to the Catalyst main menu. 2) Enter the number for "Catalyst Edit". 3) Enter "6" to move VisiCalc to the hard disk. 4) You will be asked to put the disk containing the interpreter (VisiCalc) in the internal disk drive and press the space bar. Remove the write protect tab from your disk, insert the disk and press the space bar. 5) You will be asked for the hard disk pathname of the interpreter. Enter "CATALYST/ VISICALC". 6) VisiCalc will be copied to your hard disk. Put a new write protect tab on your VisiCalc disk. Adding VisiCalc to the Catalyst menu: 1) Enter "1" to add an entry to the Catalyst menu. 2) Enter the number of the entry in the menu you want VisiCalc to precede. 3) You will be asked for the display name of this program. Enter "VisiCalc". 4) Enter "CATALYST/VISICALC " when you are asked for the interpreter pathname. 5) Then you will be asked for the character set pathname. Just press RETURN (this accepts the default character set). 6) You will also be asked if the character set should be inverted. Press RETURN for noninverted. 7) Press RETURN again to use the default keyboard. 8) Press RETURN to accept the default prefix. 9) Press RETURN for the "Max files allowed..." question to force exit via the QUIT option in VisiCalc. 10) Finally press RETURN for the program path question since VisiCalc does not use this feature. 11 a) You will be asked if this entry is correct. If it is, enter "Y", or just press RETURN. You will be allowed to insert another entry. Since you don't want to do this, enter "0" to exit to the main menu. 11 b) If you made any mistakes during entry, enter "N". You may then enter the number of the item you wish to correct. When all items are correct, enter "0". Then enter "0" again to exit to the main menu. 12) Enter "7" to update the INTERPS file. When you are asked if you want to recalculate the load address, enter "Y". (You will be required to install the Catalyst disk without a write protect tab and press space.) 13) Press space when the update is complete. Exit to the Catalyst main menu by entering "0". INSTALLING VISICALC (ADVANCED VERSION) NOTE: Advanced VisiCalc is a copy protected program. Once you have installed it on your hard disk, the disk will no longer be bootable. Label one of your two Advanced VisiCalc disks with "BACKUP" ( if you did not purchase the backup disk, it is recommended that you do so). Use this backup disk when performing the installation procedure. Once installation has been accomplished, put a label that says "Catalyst" on the backup disk. Put your backup away for safe keeping. The backup will not be bootable, but it may be copied to the hard disk again if the need ever arises. Your master disk will still be bootable and should only be used in case your hard disk breaks down. Advanced VisiCalc requires that the VCSWAPPATH. DIF file be stored on the disk in the internal disk drive. You could put this file on the Catalyst disk and then leave the Catalyst disk installed. However, this puts extra wear on your important Catalyst disk. You may wish to make a special disk for this file (if you have Apple Writer, the same disk can be used for the files required by Apple Writer). Begin by following the procedure outlined in Appendix B of the Advanced VisiCalc manual for copying program files to the hard disk. (If you have previously followed this procedure, begin again starting with step 11). Make the following modifications to the procedure: 15) Put either the Catalyst disk, or the special disk discussed above, in the internal drive with the write protect tab removed. 16) Same as step 16 in Advanced VisiCalc manual. The swapping of disks will not be required if the installation procedure has been previously performed. 17) Put a new write protect tab on your Catalyst disk, or the special disk you are using for storing this file. 18) Type "/S#S.PROFILE/AVC2/VCSWAPPATH.DIF" and then press RETURN. 19) Same as step 16 in Advanced VisiCalc manual. The swapping of disks will not be required, however. Copy procedure: 1 ) Boot your Catalyst disk (if you haven't already), set the date and time and go to the Catalyst main menu. 2) Enter the number for "Catalyst Edit". 3) Enter "6" to move Advanced VisiCalc to the hard disk. 4) You will be asked to put the disk containing the interpreter (Advanced VisiCalc) in the internal disk drive and press the space bar. Remove the write protect tab from your Loader diskette, insert the disk and press the space bar. 5) You will be asked for the hard disk pathname of the interpreter. Enter "CATALYST/ ADV.VISICALC". 6) Advanced VisiCalc will be copied to your hard disk. Put a new write protect tab on your Loader diskette Adding Advanced VisiCalc to the Catalyst menu: 1) Enter "1" to add an entry to the Catalyst menu. 2) Enter the number of the entry in the menu you want Advanced VisiCalc to precede. 3) You will be asked for the display name of this program. Enter "Adv. VisiCalc". 4) Enter "CATALYST/ADV.VISICALC" when you are asked for the interpreter pathname. 5) Then you will be asked for the character set pathname. Just press RETURN (this accepts the default character set). 6) You will also be asked if the character set should be inverted. Press RETURN for noninverted. 7) Press RETURN again to use the default keyboard. 8) Enter ".PROFILE/AVC2" when you are asked for the initial prefix. 9) Press RETURN for the "Max files allowed..." question to force exit via the QUIT option in VisiCalc. 10) Finally press RETURN for the program path question since Advanced VisiCalc does not use this feature. 11 a) You will be asked if this entry is correct. If it is, enter "Y", or just press RETURN. You will be allowed to insert another entry. Since you don't want to do this, enter "0" to exit to the main menu. 11 b) If you made any mistakes during entry, enter "N". You may then enter the number of the item you wish to correct. When all items are correct, enter "0". Then enter "0" again to exit to the main menu. 12) Enter "7" to update the INTERPS file. When you are asked if you want to recalculate the load address, enter "Y". (You will be required to install the Catalyst disk with the write protect tab removed and press space for this step.) 13) Press space when the update is complete. Exit to the Catalyst main menu by entering "0". INSTALLING PASCAL The Pascal run time system has already been installed. To complete the installation of Pascal you must follow the instructions that came with the ProFile for putting Pascal on your ProFile. Do NOT recopy the file SYSTEM.PASCAL when you do this! Adding Pascal to the Catalyst menu: 1) Boot your Catalyst disk (if you haven't already), set the date and time and go to the Catalyst main menu. 2) Enter the number for "Catalyst Edit". 3) Enter "1" to add an entry to the Catalyst menu. 4) Enter the number of the entry in the menu you want Pascal to precede. 5) You will be asked for the display name of this program. Enter "Pascal". 6) Enter "CATALYST/PASCAL" when you are asked for the interpreter pathname. 7) Then you will be asked for the character set pathname. Just press RETURN (this accepts the default character set). 8) You will also be asked if the character set should be inverted. Press RETURN for noninverted. 9) Press RETURN again to use the default keyboard. 10) Press RETURN to accept the default prefix. 11 ) Enter "0" for the "Max files allowed... " question. This will allow Pascal to be exited by holding down both apple keys and pressing ESCAPE. 12) Also press RETURN for the program path question (The Pascal SYSTEM.STARTUP program supplied by Quark uses this option, but not in this case). 13a) You will be asked if this entry is correct. If it is, enter "Y", or just press RETURN. You will be allowed to insert another entry. Since you don't want to do this, enter "0" to exit to the main menu. 13b) If you made any mistakes during entry, enter "N". You may then enter the number of the item you wish to correct. When all items are correct, enter "0". Then enter "0" again to exit to the main menu. 14) Enter "7" to update the INTERPS file. When you are asked if you want to recalculate the load address, enter "Y". (You will be required to install the Catalyst disk with the write protect tab removed and press space for this step.) 15) Press space when the update is complete. Exit to the Catalyst main menu by entering "0". INSTALLING COBOL COBOL special considerations: Begin by following the procedure set forth in the COBOL manual for putting COBOL on the hard disk. Copy procedure: 1) Boot your Catalyst disk (if you haven't already), set the date and time and go to the Catalyst main menu. 2) Enter the number for "Catalyst Edit". 3) Enter "6" to move COBOL to the hard disk. 4) You will be asked to put the disk containing the interpreter (COBOL) in the internal disk drive and press the space bar. Remove the write protect tab from your disk, insert the disk and press the space bar. 5) Enter "CATALYST/COBOL" when you are asked for the hard disk pathname of the interpreter. 6) COBOL will be copied to your hard disk. Put a new write protect tab on your COBOL disk. Adding COBOL to the Catalyst menu: 1) Enter "1" to add an entry to the Catalyst menu. 2) Enter the number of the entry in the menu you want COBOL to precede. 3) You will be asked for the display name of this program. Enter "COBOL". 4) You will be asked for the interpreter pathname. Enter "CATALYST/COBOL". 5) Then you will be asked for the character set pathname. Just press RETURN (this accepts the default character set). 6) You will also be asked if the character set should be inverted. Press RETURN for noninverted. 7) Press RETURN again to use the default keyboard. 8) Press RETURN to accept the default prefix. 9) Press RETURN for the "Max files allowed..." question to force exit via the QUIT option in COBOL. 10) Finally press RETURN for the program path question since COBOL does not use this feature. 11 a) You will be asked if this entry is correct. If it is, enter "Y", or just press RETURN. You will be allowed to insert another entry. Since you don't want to do this, enter "0" to exit to the main menu. 11 b) If you made any mistakes during entry, enter "N". You may then enter the number of the item you wish to correct. When all items are correct, enter "0". Then enter "0" again to exit to the main menu. 12) Enter "7" to update the INTERPS file. When you are asked if you want to recalculate the load address, enter "Y". (You will be required to install the Catalyst disk with the write protect tab removed and press space for this step.) 13) Press space when the update is complete. Exit to the Catalyst main menu by entering "0". INSTALLING BASIC If you have any programs that use BASIC, you will be required to follow this procedure. If you don't actually have a BASIC disk, use whatever disk you normally boot to run your BASIC program as the BASIC disk. Copy procedure: 1) Boot your Catalyst disk (if you haven't already), set the date and time and go to the Catalyst main menu. 2) Enter the number for "Catalyst Edit". 3) Enter "6" to move BASIC to the hard disk. 4) You will be asked to put the disk containing the interpreter (BASIC) in the internal disk drive and press the space bar. Remove the write protect tab from your disk, insert the disk and press the space bar. 5) You will be asked for the hard disk pathname of the interpreter. Enter "CATALYST/BASIC". 6) BASIC will be copied to your hard disk. Put a new write protect tab on your BASIC disk. Adding BASIC to the Catalyst menu: 1) Enter "1" to add an entry to the Catalyst menu. 2) Enter the number of the entry in the menu you want BASIC to precede. 3) You will be asked for the display name of this program. Enter "BASIC". 4) Enter "CATALYST/BASIC" when you are asked for the interpreter pathname. 5) Then you will be asked for the character set pathname. Just press RETURN (this accepts the default character set). 6) RETURN for non-inverted. 7) Press RETURN again to use the default keyboard. You will also be asked if the character set should be inverted. Press 8) Press RETURN to accept the default prefix. 9) Enter "0" for the "Max files allowed... " question. This will allow BASIC to be exited by holding down both apple keys and pressing ESCAPE. 10) Also press RETURN for the program path question (The BASIC HELLO program supplied by Quark uses this option, but not in this case). 11 a) You will be asked if this entry is correct. If it is, enter "Y", or just press RETURN. You will be allowed to insert another entry. Since you don't want to do this, enter "0" to exit to the main menu. 11 b) If you made any mistakes during entry, enter "N". You may then enter the number of the item you wish to correct. When all items are correct, enter "0". Then enter "0" again to exit to the main menu. 12) Enter "7" to update the INTERPS file. When you are asked if you want to recalculate the load address, enter "Y". (You will be required to install the Catalyst disk with the write protect tab removed and press space for this step.) 13) Press space when the update is complete. Exit to the Catalyst main menu by entering "0". INSTALLING APPLE WRITER /// NOTE: Apple Writer /// is a copy protected program. Once you have installed it on your hard disk, the disk will no longer be bootable. Label one of your two Apple Writer /// disks with "BACKUP". Use this backup disk when performing the installation procedure. Once installation has been accomplished, put a label that says "Catalyst" on the backup disk. Put your backup away for safe keeping. The backup will not be bootable, but it can be copied to the hard disk again if the need ever arises. Your master disk will still be bootable and should only be used in case your hard disk breaks down. Early versions of Apple Writer cannot be easily put on the hard disk. An early version can be detected by the existence of a 1981 copyright date and the complete lack of a version number. If you have a 1 28K machine, it will probably be impossible to use an early version of Apple Writer at all. On a 256K machine, it will be necessary to have a special disk installed in the internal drive to allow Apple Writer to read the tab, print format and help files (SYS.TAB, SYS.PRT, HELP and the HS subdirectory). You could just copy these files to the Catalyst disk and then leave the Catalyst disk installed. However, this puts extra wear on your Important Catalyst disk. You may wish to make a special disk for these files (If you made a special disk for the Advanced VisiCalc file, VCSWAPPATH.DIF, you may use this disk). If you have an early version of Apple Writer, contact your Apple dealer to check on availability of a version of Apple Writer that eliminates these problems. Copy procedure: 1) Boot your Catalyst disk (if you haven't already), set the date and time and go to the Catalyst main menu. 2) Enter the number for "Catalyst Edit". 3) Enter "6" to move Apple Writer to the hard disk. 4) You will be asked to put the disk containing the interpreter (Apple Writer ///) in the internal disk drive and press the space bar. Remove the write protect tab from your disk, insert the disk and press the space bar. 5) You will be asked for the hard disk pathname of the interpreter. Enter "CATALYST/ APPLE.WRITER". 6) Apple Writer will be copied to your hard disk. Put a new write protect tab on your Apple Write disk. Adding Apple Writer to the Catalyst menu: 1) Enter "1" to add an entry to the Catalyst menu. 2) Enter the number of the entry in the menu you want Apple Writer to precede. 3) You will be asked for the display name of this program. Enter "Apple Writer". 4) Enter "CATALYST/APPLE.WRITER" when you are asked for the interpreter pathname. 5) Then you will be asked for the character set pathname. Just press RETURN (this accepts the default character set). 6) You will also be asked if the character set should be inverted. Press RETURN for noninverted. 7) Press RETURN again to use the default keyboard. 8) Press RETURN to accept the default prefix. 9) Press RETURN to force exits from Apple Writer /// only via the QUIT option in the miscellaneous commands menu. 10) Finally press RETURN for the program path question since Apple Writer does not support this feature. 11 a) You will be asked if this entry is correct. If it is, enter "Y", or just press RETURN. You will be allowed to insert another entry. Since you don't want to do this, enter "0" to exit to the main menu. 11 b) If you made any mistakes during entry, enter "N". You may then enter the number of the item you wish to correct. When all items are correct, enter "0". Then enter "0" again to exit to the main menu. 12) Enter "7" to update the INTERPS file. When you are asked if you want to recalculate the load address, enter "Y". (You will be required to install the Catalyst disk with the write protect tab removed and press space for this step.) 13) Press space when the update is complete. Exit to the Catalyst main menu by entering "0". INSTALLING PROGRAMS INSTALLING MAIL LIST MANAGER You may move Apple's Mail List Manager (MLM) to the hard disk. This will allow you to access it with greater ease than by using a floppy. However, such transfer does not allow you to store MLM files on the hard disk (unless you have Mail List Manager version 11 ). Your mailing lists must still be stored on floppies. Copy procedure: 1) Boot the Catalyst disk (if you haven't already). 2) From the main Catalyst menu, select the Sys Utilities program. 3) Press "F" for File handling commands. 4) Press "M" for make subdirectory. 5) Enter ".PROFILE/CATALYST/MLM". 6) Press RETURN to accept the default size of 25 files for the subdirectory. 7) Press ESCAPE. 8) Put the diskette containing Mail List Manager in the internal drive. 9) Press "C" for Copy files. 10) Copy all files on the Mail List Manager diskette except the following: SOS.KERNEL, SOS.DRIVER, SOS.INTERP, SYSTEM.PASCAL, SYSTEM.MISCINFO 11) To do this, type ".D1/" and press the up arrow key. 12) A list of files is displayed in a box. The up and down arrow keys allow you to move put an inverse bar over the name of your choice. Pressing the right arrow key marks the file so as to include it in the copy process. Mark all files to be copied in this way. When all: files are marked, press RETURN. 13) Enter ".PROFILE/CATALYST/MLM/=" for the name of the destination file. 14) When all files have been copied, hold down both apple keys and press ESCAPE to return to the Catalyst menu. Adding Mail List Manager to the Catalyst menu: 1) Enter the number for "Catalyst Edit". 2) Enter "1" to add an entry to the menu. 3) Enter the number of the menu entry you want Mail List Manager to precede. 4) You will be asked for the display name of this program (the name that appears in the Catalyst menu). Enter something appropriate consisting of 13 or fewer characters (probably "Mail List"). 5) You will be asked for the interpreter pathname. Since this is a Pascal program, enter "CATALYST/PASCAL". 6) Enter "CATALYST/MLM/MLMSET" as the pathname for the character set. 7) You will also be asked if the character set should be inverted. Press RETURN for noninverted. 8) Press RETURN again to use the default keyboard. 9) Press RETURN to accept the default prefix. 10) Enter "3" for the "Max files allowed..." question. This will allow the program to be exited by holding down both apple keys and pressing ESCAPE. (The value 3 suppresses the DISK FILES OPEN warning.) 11 ) Enter "CATALYST/MLM,SYSTEM.STARTUP" when you are asked for the program path. (This will give a bad path error, but ignore it.) 12a) You will be asked if this entry is correct. If it is, enter "Y", or just press RETURN ( remember, certain entries for program path will give erroneous errors). You will be allowed to insert another entry. Since you don't want to do this, enter "0" to exit to the main menu. 12b) If you made any mistakes during entry, enter "N". You may then enter the number of the item you wish to correct. When all items are correct, enter "0". Then enter "0" again to exit to the main menu. 13) Enter "7" to update the INTERPS file. When you are asked if you want to recalculate the load address, enter "N". 14) Exit to the Catalyst main menu by entering "0". INSTALLING BUSINESS GRAPHICS You may move Business Graphics to the hard disk. This will allow you to access it with greater ease than by using a floppy. However, because of the particular copy protection scheme used for Business Graphics, you will need to install the Business Graphics disk in the internal drive before using it. The .GRAFIX driver must be installed on your Catalyst disk. Additionally, 16K of graphics space must be allocated in Pascal. If you get the message "INSUFFICIENT GRAPHICS SPACE ALLOCATED" when trying to invoke Business Graphics, you may allocate graphics space by pressing "O" (Oh) from the Pascal command line. Then press "A", then "C", then "Q". Pascal will be restarted. Enter "O" to return to Catalyst. You may then re-enter Business Graphics successfully. Copy procedure: 1) Boot the Catalyst disk (if you haven't already). 2) From the main Catalyst menu, select the Sys Utilities program. 3) Press "F" for File handling commands. 4) Press "M" for make subdirectory. 5) Enter ".PROFILE/CATALYST/BG". 6) Press RETURN to accept the default size of 25 files for the subdirectory. 7) Press ESCAPE. 8) Put the Business Graphics master diskette in the internal drive. 9) Press "C" for Copy files. 10) Copy all files on your master diskette except for the following: SYSTEM.PLOT, SYSTEM.PASCAL, SYSTEM.LIBRARY, SYSTEM.MISCINFO 11) To do this, type ".D1/" and press the up arrow key. 12) A list of files is displayed in a box. The up and down arrow keys allow you to move put an inverse bar over the name of your choice. Pressing the right arrow key marks the file so as to include it in the copy process. Mark all files to be copied in this way. (Note that if there are more files than can be displayed on the screen, pressing down arrow at the bottom of the file box causes scrolling.) When all files are marked, press RETURN. 13) Enter ".PROFILE/CATALYST/BG/=" for the name of the destination file. 14) After all files have been copied, you must copy the SYSTEM.LIBRARY file. Enter ".D1/SYSTEM.LIBRARY" as the name of the source file. 15) Enter ".PROFILE/CATALYST/BG/PLOT.LIB" as the name of the destination file. 16) When the copy is complete, insert the Business Graphics Data diskette in the internal drive. 17) Enter ".D1/=H.TEXT" as the source file name. 18) Enter ".PROFILE/CATALYST/BG/=H.TEXT" as the destination file name. 19) When these file have been copied, enter ".D1/CHANGE.CODE" as the name of the next file of copy. 20) Enter ".PROFILE/CATALYST/BG/CHANGE.CODE" as the name of the destination file. 18) Press ESCAPE once the copy is complete. 19) Hold down both apple keys and press ESCAPE to return to the Catalyst menu. Adding Business Graphics to the Catalyst menu: 1) Enter the number for "Catalyst Edit". 2) Enter "1" to add an entry to the menu. 3) Enter the number of the menu entry you want Business Graphics to precede. 4) Enter "Bus. Grafix" as the display name. 5) You will be asked for the interpreter pathname. Since this is a Pascal program, enter "CATALYST/PASCAL". 6) Then you will be asked for the character set pathname. Just press RETURN (this accepts the default character set). 7) You will also be asked if the character set should be inverted. Press RETURN for non-inverted. 8) Press RETURN again to use the default keyboard. 9) Press RETURN to accept the default prefix. 10) Enter "3" for the "Max files allowed..." question. This will allow the program to be exited by holding down both apple keys and pressing ESCAPE. (The value 3 suppresses the DISK FILES OPEN warning.) 11) Enter "*.PROFILE/CATALYST/BG,SYSTEM.STARTUP" when you are asked for the program path. (This will give a bad path error, but ignore it.) 12a) You will be asked if this entry is correct. If it is, enter "Y", or just press RETURN (remember, certain entries for program path will give erroneous errors). You will be allowed to insert another entry. Since you don't want to do this, enter "O" to exit to the main menu. 12b) If you made any mistakes during entry, enter "N". You may then enter the number of the item you wish to correct. When all items are correct, enter "O". Then enter "O" again to exit to the main menu. 13) Enter "7" to update the INTERPS file. When you are asked if you want to recalculate the load address, enter "N". 14) Exit to the Catalyst main menu by entering "O". In order for Business Graphics to access the HELP files, you must enter Business Graphics and enter the following: SET DEFAULT VOL .PROFILE/ CATALYST/BG INSTALLING MISCELLANEOUS BASIC PROGRAHS Putting an arbitrary BASIC program on the hard disk may be a fairly arduous (and sometimes impossible) task. If you are its author this will probably not be a problem. You merely move the program to some appropriate place. Remember to move its data files and any other programs it may require. Then it is merely necessary to modify any specific references to the floppy disk for programs and data. When you are through, add the program to the Catalyst menu. In the case that you are not the author, you should contact the manufacturer of the program for assistance in making the transfer. If the manufacturer has any questions, they can contact Quark directly. For many simple programs (programs that require only one disk), the following procedure will works: Copy procedure: 1) Boot the Catalyst disk (if you haven't already). 2) From the main Catalyst menu, select the Sys Utilities program. 3) Press "F" for File handling commands. 4) Press "M" for make subdirectory. 5) You will now create a subdirectory in the CATALYST subdirectory for storing the program and its associated files. For example, for Inkwell, you might enter ".PROFILE/ CATALYST/IW". Replace the "IW" by a subdirectory name which describes the program you are installing. 6) Press RETURN to accept the default size of 25 files for the subdirectory. 7) Press ESCAPE. 8) Put the diskette containing your programs in the internal drive. 9) Press "C" for Copy files. 10) Copy all files on your program diskette except the following: SOS.KERNEL, SOS.DRIVER, SOS.INTERP 11) To do this, type ".D1/" and press the up arrow key. 12) A list of files is displayed in a box. The up and down arrow keys allow you to move put an inverse bar over the name of your choice. Pressing the right arrow key marks the file so as to include it in the copy process. Mark all files to be copied in this way. (Note that if there are more files than can be displayed on the screen, pressing down arrow at the bottom of the file box causes scrolling.) When all files are marked, press RETURN. 13) For the name of the destination file enter the subdirectory path name followed by "/=". For example, if the subdirectory was called "IW", you would enter ".PROFILE/CATALYST/ IW/=". 14) When all files have been copied, hold down both apple keys and press ESCAPE to return to the Catalyst menu. Adding the program to the Catalyst menu: 1) Enter the number for "Catalyst Edit". 2) Enter "1" to add an entry to the menu. 3) Enter the number of the menu entry you want this program to precede. 4) You will be asked for the display name of this program ( the name that appears in the Catalyst menu). Enter something appropriate consisting of 13 or fewer characters. 5) You will be asked for the interpreter pathname. Since this is a BASIC program, enter "CATALYST/BASIC". 6) Then you will be asked for the character set pathname. Just press RETURN (this accepts the default character set). 7) You will also be asked if the character set should be inverted. Press RETURN for noninverted. 8) Press RETURN again to use the default keyboard. 9) Enter ".PROFILE/CATALYST" as the initial prefix. 10) Enter "0" for the "Max files allowed..." question. This will allow the program to be exited by holding down both apple keys and pressing ESCAPE. 11) When you are asked for the program path, you may enter one of the following (this example uses the subdirectory "IW", you will have to use your own subdirectory name): a) ".PROFILE/CATALYST/IW/HELLO" b) ".PROFILE/CATALYST/IW,HELLO" c) "*.PROFILE/CATALYST/IW,HELLO" The last two will generate a bad path error, but the error should be ignored. Use option "a" if only a single program file exists in the subdirectory. Use option "b" if more that one program file exists or if any data files are present. Use option "c" if the program diskette must be inserted for the program to operate (protected programs such as PFS require this). 12a) You will be asked if this entry is correct. If it is, enter "Y", or just press RETURN ( remember, certain entries for program path will give erroneous errors). You will be allowed to insert another entry. Since you don't want to do this, enter "0" to exit to the main menu. 12b) If you made any mistakes during entry, enter "N". You may then enter the number of the item you wish to correct. When all items are correct, enter "0". Then enter "0" again to exit to the main menu. 13) Enter "7" to update the INTERPS file. When you are asked if you want to recalculate the load address, enter "N". 14) Exit to the Catalyst main menu by entering "0".- INSTALLING MISCELLANEOUS PASCAL PROGRAMS Putting an arbitrary Pascal program on the hard disk may be a fairly arduous (and sometimes impossible) task. If you are its author this will probably not be a problem. You merely move the program to some appropriate place. Remember to move its data files and any other programs it may require. Then it is merely necessary to modify any specific references to the floppy disk for programs and data. When you are through, add the program to the Catalyst menu. In the case that you are not the author, you should contact the manufacturer of the program for assistance in making the transfer. If the manufacturer has any questions, they can contact Quark directly. For many simple programs, the following procedure often works. Copy procedure: 1) Boot the Catalyst disk (if you haven't already). 2) From the main Catalyst menu, select the Sys Utilities program. 3) Press "F" for File handling commands. 4) Press "M" for make subdirectory. 5) You will now create a subdirectory in the CATALYST subdirectory for storing the program and its associated files. For example, for Mail List Manager, you might enter ".PROFILE/ CATALYST/MLM". Replace the "MLM" by a descriptive subdirectory name. 6) Press RETURN to accept the default size of 25 files for the subdirectory. 7) Press ESCAPE. 8) Put the diskette containing your programs in the internal drive. 9) Press "C" for Copy files. 10) Copy all files on your program diskette except the following: SOS.KERNEL, SOS.DRIVER, SOS.INTERP, SYSTEM.PASCAL, SYSTEM.MISCINFO 11) To do this, type ".D1/" and press the up arrow key. 12) A list of files is displayed in a box. The up and down arrow keys allow you to move put an inverse bar over the name of your choice. Pressing the right arrow key marks the file so as to include it in the copy process. Mark all files to be copied in this way. (Note that if there are more files than can be displayed on the screen, pressing down arrow at the bottom of the file box causes scrolling.) When all files are marked, press RETURN. 13) For the name of the destination file enter the subdirectory path name followed by "/=". For example, if the subdirectory was called "MLM", you would enter ".PROFILE/CATALYST/ MLM/=". 14) When all files have been copied, press ESCAPE. 15) If you did not copy a file named "SYSTEM.LIBRARY", skip to step 19. 16) Press "R" to rename a file. 17) Change the name of the SYSTEM.LIBRARY file to "SYSTEM.STAR.LIB". For example, if the subdirectory was called "MLM", you would use ".PROFILE/CATALYST/MLM/ SYSTEM.LIBRARY" as the old file name. As the new file name you would use ".PROFILE/ CATALYST/MLM/SYSTEM.STAR.LIB". If the SYSTEM.STAR.LIB file already exists, contact the manufacturer of the program for assistance. 18) Press ESCAPE once the rename is complete. 19) Hold down both apple keys and press ESCAPE to return to the Catalyst menu. Adding the program to the Catalyst menu: 1) Enter the number for "Catalyst Edit". 2) Enter "1" to add an entry to the menu. 3) Enter the number of the menu entry you want this program to precede. 4) You will be asked for the display name of this program (the name that appears in the Catalyst menu). Enter something appropriate consisting of 13 or fewer characters. 5) You will be asked for the interpreter pathname. Since this is a Pascal program, enter "CATALYST/PASCAL". 6) Then you will be asked for the character set pathname. Just press RETURN (this accepts the default character set). 7) You will also be asked if the character set should be inverted. Press RETURN for noninverted. 8) Press RETURN again to use the default keyboard. 9) Press RETURN to accept the default prefix. 10) Enter "3" for the "Max files allowed..." question. This will allow the program to be exited by holding down both apple keys and pressing ESCAPE. (The value 3 suppresses the DISK FILES OPEN warning.) 11) When you are asked for the program path, you may enter one of the following ( this example uses the subdirectory "MLM", you will have to use your own subdirectory name): a) ".PROFILE/CATALYST/MLM/SYSTEM.STARTUP" b) ".PROFILE/CATALYST/ MLM,SYSTEM.STARTUP" c) "*.PROFILE/CATALYST/MLM,SYSTEM.STARTUP" The last two will generate a bad path error, but the error should be ignored. Use option "a" if only one code file exists in the subdirectory. Use option "b" if more that one code file exists or any data files exist. Use option "c" if the program diskette must be inserted for the program to operate (protected programs such as PFS require this). 12a) You will be asked if this entry is correct. If it is, enter "Y", or just press RETURN ( remember, certain entries for program path will give erroneous errors). You will be allowed to insert another entry. Since you don't want to do this, enter "0" to exit to the main menu. 12b) If you made any mistakes during entry, enter "N". You may then enter the number of the item you wish to correct. When all items are correct, enter "0". Then enter "0" again to exit to the main menu. 13) Enter "7" to update the INTERPS file. When you are asked if you want to recalculate the load address, enter "N". 14) Exit to the Catalyst main menu by entering "0". INSTALLING THE SPOOLER Early versions of the Quark spooler are called TranScribe. These early versions should not be used with Catalyst. Only later versions of the spooler should be used. These later versions go by the name Discourse. If you have a copy of TranScribe, you may return your disk to Quark to have it updated to the Discourse version. Under no circumstances should TranScribe be installed on the Catalyst disk. Installation of Discourse proceeds in much the manner set forth in the Discourse manual. You do not need to replace CONSOLE and printer drivers, though. Your Discourse comes with SOS version 13. You will also not need to update the SOS.KERNEL file on your Catalyst disk since this update has already been performed for you. FINISHED AT LAST Your Catalyst is now completely installed. From the main menu, select the "Sys Reboot" option. When the reboot message appears, press CONTROL RESET with the Catalyst disk installed. This readjusts the interpreter load address. Now you can select any program you like. Try each one. Once the program is started, return to the Catalyst menu and try the next one. Verify that they all work. The procedure for exiting each program is detailed in Appendix E. If you get any errors, check Appendix B for details. SETTING UP YOUR BACKUP CATALYST DISK Once you have verified that your Catalyst installation is complete, you may wish to set up your backup Catalyst disk to match your master. You may do this as follows: 1) Delete the DRIVERS.128 and DRIVERS.256 files from the backup disk. 2) Copy the SOS.DRIVER file from your master disk to your backup. 3) Boot your backup disk. 4) Use option 7 (Update INTERPS file) in the Catalyst Editor. When you are asked if the minimum interpreter load address should be recalculated, enter "Y". When you are asked for the Catalyst disk, use the backup. Your master and backup disks are now identical. BACKING UP YOUR HARD DISK You should now backup your hard disk. If you have a copy of the Backup /// program, use it! If your hard disk ever crashes you can recover from the backup you make now and avoid performing the tedious installation procedure again later. Even the versions of copy protected programs which you have moved to your hard disk can be backed up (and recovered) in this way. CHAPTER 3 USING CATALYST STARTING CATALYST To start Catalyst, you merely boot the Catalyst disk. If your hard disk is not up to speed or is non-operational, the message "*** DRIVE NOT READY ***" will appear. When the disk is ready, you press RETURN to start up your system. If the hard disk is ready, Catalyst starts up immediately. Catalyst may display the time and date and ask you to verify that they are correct. If they are, entering "Y" or simply pressing RETURN takes you to the Catalyst main menu. If they are not correct, entering "N" will allow you to change them. The date is entered in the form MM/DD/YY, (e.g. 10/18/82 for October 18th, 1982). If the date is correct, pressing only RETURN will leave it unmodified. The time is entered based on a 24-hour clock. The form for time entry is HH:MM or HH:MM:SS (e.g. 14:30 for 2:30 PM or 3:23:10 for 3:23 AM and 10 seconds). If the seconds are omitted, the "second hand" on the clock is left untouched. Pressing just RETURN leaves the time unchanged. After the proper date and time have been entered, you are again asked if they are correct. This gives you a second chance to get them right. When the date and time are correct, enter "Y" or just press RETURN to go to the Catalyst main menu. Catalyst need not always ask you for the time. Whether it asks you or not is controllable (see the section entitled CONTROLLING THE DATE AND TIME REQUEST). If you make a mistake in entry you may use any of three keys to delete the previous character. The right arrow key, the "-" key on the numeric keypad and the DELETE key may all be used for this purpose (not all Apple ///'s have a DELETE key). Once in the Catalyst main menu, you may select any program on the menu by entering its number and pressing RETURN. If your Catalyst is set up to automatically start a particular program at power on, you will not have an opportunity to select a program. The program which has been specified as the startup program will be automatically run (see the section entitled SELECTING A STARTUP PROGRAM for details). CHANGING PROGRAMS Eventually, you will need to change which program you are using. The procedure to exit your current program and return to the Catalyst menu varies considerably. Here are the procedures you use to exit from some of the more common programs: PROGRAM EXIT PROCEDURE Apple Writer /// -- In the miscellaneous commands menu, use the QUIT option. BASIC -- Hold down both apple keys and press ESCAPE. BASIC Startup -- Use "0" in the main menu. Catalyst Editor -- Use "0" in the main menu. COBOL -- Use the QUIT option in the main command line. Mail List Manager -- Use the Mail List Manager QUIT option. Then hold down both apple keys and press ESCAPE. Pascal -- Hold down both apple keys and press ESCAPE. In Pascal 11, use the QUIT option in the main command line. Pascal Startup -- Use "0" in the main menu. PFS -- Hold down both apple keys and press ESCAPE in the main PFS menu. VisiCalc -- Type "/SQY". VisiCalc (Advanced) -- Type "/SQY". Word Juggler -- Use the REBOOT or QUIT option in the main menu. For other programs, a quit option may be provided. If so, use it. For BASIC programs, this may simply terminate the program. This is indicated by the ")" as a prompt followed by the inverse cursor. Once you get to this point, hold down both apple keys and press ESCAPE to get to the Catalyst menu. For Pascal programs, the quit option may take you to the Pascal command line. Once you get to this point, hold down both apple keys and press ESCAPE to get to the Catalyst menu or use the QUIT option (if available). If all else fails, attempt to exit by holding down both apple keys and pressing ESCAPE. The above procedure for getting to the Catalyst menu has some interesting properties. If any disk files are open (actually, if more than the number allowed are open), a warning will be issued. The warning is "DISK FILES OPEN". Terminating a program that has disk files open may be a problem. Hopefully, the individual who installed your Catalyst allowed for this. If you decide that you don't really want to change programs in this way, press ESCAPE and you will be returned to your program. THE SYSTEM REBOOT PROGRAM The program called "Sys Reboot" which appears in your menu should be executed whenever you want to reboot your Apple /// or when you are ready to turn the machine off. The "Sys Reboot" program will make sure it is OK to do so. If it is, the message "INSERT SYSTEM DISKETTE & REBOOT" will appear. Probably the only other message of interest is the "SPOOLER QUEUE NOT EMPTY" message. This message can only occur if you have Discourse installed. If you get this message, you may do one of two things. You may hold down both apple keys and press ESCAPE to return to the Catalyst menu. If you do nothing, the "SPOOLER QUEUE NOT EMPTY" message will be displayed until the spooler queue becomes empty, then the REBOOT message will appear. MORE ON THE CATALYST EDITOR The Catalyst Editor allows you to edit the contents of the Catalyst menu. It also controls certain startup options and aids in the installation of interpreters. Any of three keys may be used throughout the Catalyst Editor to delete the previous character. The right arrow key, the "-" key on the numeric keypad and the DELETE key may all be used for this purpose (not all Apple ///'s have a DELETE key). Also throughout the Catalyst Editor (and in all other Quark programs for that matter), YES/NO questions may be answered with just the first letter ("Y" or "N"). Simply pressing RETURN will always be interpreted as YES. Errors that may be encountered during operation of the Catalyst Editor are displayed as the flashing word ERROR in the lower left hand corner of the display followed by the text of the error. The error may be cleared out by pressing the ESCAPE key. For information on a specific error, refer to Appendix B. ADDING MENU ENTRIES Option 1 allows entries to be added to the Catalyst menu. The Catalyst menu can contain at most 30 entries. When option 1 is selected, a list of the current entries is displayed. You enter the number of the entry you want your new entry to precede. Thus entering "1 " makes the new entry the first one on the list. If there are ten entries in the menu, entering "11" makes the new entry the last one in the list. Once a position for the new entry has been selected, you are asked for the values of the eight items that make up the entry. The meanings of these items are as follows: 1) Display name - A 1 to 13 character name for the program that will be displayed in the Catalyst menu. 2) Interpreter path - The path name for the interpreter being used. 3) Character set path - The path name for the character set file to use. Pressing RETURN uses the default character set. 4) Screen - The normal/inverse flag. "N" displays white (or green?) characters on a black background. "I" displays black characters on a green (or white?) background. 5) Keyboard path - The path name for the keyboard layout file. Pressing RETURN uses the default keyboard layout. 6) Initial prefix - The prefix setting used when the interpreter is started. Pressing RETURN leaves the prefix set to the root directory of the boot device. Not all interpreters this prefix setting. 7) Max files allowed open - This specifies the number of disk files that may be open when double apple ESCAPE is pressed. If more files are open than this, a warning will be produced. If it is set to an "*", double apple ESCAPE cannot be used to exit the program. 8) Program path - This is a user defined pathname. It is used by the BASIC HELLO program and the Pascal SYSTEM.STARTUP program supplied by Quark. These programs use the program path to determine which program to run. The Max files parameter allows you to prevent inappropriate exits from a program. An "*" for this parameter, stops the use of double apple ESCAPE entirely. This is the preferred value for Max files. In many cases, however, a program doesn't provide for an appropriate exit, so double apple ESCAPE must be used. In these instances it is desirable to warn the user if there are files open which need to be updated and closed by the program (Catalyst will close these file, but it some cases, a simple close may not be sufficient). Ideally, all files should be closed when an application is exited. Using "0" for the Max files parameter accomplishes this. "0" is generally a good value to use for BASIC programs. Programs written in Pascal generally have a number of program files opened all the time. A value of "3" is often a good value for Pascal programs. Note that just because this error is produced doesn't mean that a exit is unsafe. The warning is produced regardless of whether the files are open for reading or writing. Only file-s opened for writing are potential sources of trouble. The format of the program path is as follows: [*][prefix path,][program name] If the "*" is present, the user will be requested to install a program disk before the program is actually run. This is useful for certain programs which are copy protected. Such a program may require that their disks be installed in the internal drive before they can function. If the prefix path is present, the prefix will be set as indicated before running the program. The sections in chapter 2 covering installation of miscellaneous BASIC and Pascal programs discusses the use of the most common forms of the Program path parameter. Once values for these have been entered, you will be asked if everything is OK. If it is enter "Y" or just press RETURN. You will returned to the Add Entries menu and allowed to add another entry. Entering "0" will return you to the main menu. If you need to correct one of the items, you may enter "N". This will allow you to edit the items using a procedure similar to that described in the next section. Once an entry has been added, you must use option 7 to update the INTERPS file for the change to be effective. EDITING MENU ENTRIES Option 2 allows entries in the Catalyst menu to be altered. When option 2 is selected, a list of the entries in the Catalyst menu is displayed. You merely enter the number of the entry to edit. A numbered list of the items in the entry will be displayed. Any item may be edited by entering its number. A new value for that item will then be requested. Once all edits have been made, entering a 11011 will allow you to select another entry to edit. If "0" is entered again, you are returned to the main menu. Once an entry has been changed, you must use option 7 to update the INTERPS file for the change to be effective. DELETING MENU ENTRIES Option 3 allows entries to be removed from the Catalyst menu. When option 3 is selected, a list of the entries in the Catalyst menu is displayed. You merely enter the number of the entry to delete. Once the entry is removed, you will be asked for the number of the next entry to delete. Entering "0" returns you to the Catalyst Editor menu. Once an entry has been deleted, you must use option 7 to update the INTERPS file for the change to be effective. SELECTING A STARTUP PROGRAM Catalyst has a feature that allows you to automatically start a program at power up. Option 4 in the Catalyst Editor allows you to control this feature. When you enter "4 ", you may specify any of the programs in the list to be used as the startup program. Entering "0" means that no program is automatically started at power up. Once the startup program has been changed, you must use option 7 to update the INTERPS file for the change to be effective. CONTROLLING THE DATE AND TIME REQUEST Option 5 in the Catalyst Editor menu allows you to control whether the date and time will be requested when Catalyst is initially booted. There are three different types of requests. They are: 1 ) Never verify that date and time are correct. 2) Verify date and time if they are not known. 3) Always verify date and time. Entering "5" in the Catalyst Editor menu will change the request type to the next one on the list. Once the request type has been changed, you must use option 7 to update the INTERPS file for the change to be effective. UPDATING THE INTERPS FILE Option 7 in the Catalyst Editor menu allows you to make permanent all the changes made in the Catalyst configuration. Unless you use option 7, all changes made in the Catalyst Editor will be forgotten as soon as you return to the Catalyst main menu (except that interpreters moved to the hard disk will still have been moved). When you use the update option, you will be asked if you wish to recalculate the interpreter minimum load address. If you have just added an interpreter, replaced an interpreter with an updated version, or deleted an interpreter you should answer with "Y". Otherwise, you should answer with "N". If you accidentally enter "Y" don't worry, the minimum interpreter load address will be recalculated. This will take a little time, and is not really necessary since no interpreters were changed, but no harm will be done. If an interpreter has been added, deleted or updated, you must answer with "Y". This causes Catalyst to determine the amount of memory to reserve for interpreters (space is reserved for the largest interpreter). In order for the recalculated load address to be valid, you must reboot the Apple. If the largest interpreter was deleted or replaced with a updated version that is smaller, extra memory will be made available to any program capable of using it. If an interpreter is added which is larger than any other interpreter, more memory will be reserved the next time you boot the Apple. If you try to access such an interpreter without rebooting, the message "INTERP TOO BIG" will occur when you attempt access. This is also the case if an updated version of an interpreter is installed which requires more than the currently allocated memory space. CHAPTER 4 ADVANCED INFORMATION The BASIC and Pascal menu programs supplied by Quark are used to get the interpreter to start running a particular program once it has invoked from Catalyst. They may also be used to display another menu of programs which the user may select from. Special programs are provided for editing these menus. These menu editors behave much like the Catalyst menu editor. USING THE BASIC STARTUP PROGRAM The BASIC startup program which is supplied by Quark is used to select between a number of BASIC programs. It also is used by Catalyst to get BASIC to automatically run a program when it is started. The initial setup of this program contains only one program. This is the program which edits the menu used by the startup program. To use the BASIC startup program, make an entry in the Catalyst menu like this: 1 ) Display name: Whatever you want 2) Interpreter path: CATALYST/BASIC 3) Character set path: Whatever you want 4) Screen: Either NORMAL or INVERTED (whichever you prefer) 5) Keyboard path: Whatever you want 6) Initial prefix: PROFILE/CATALYST 7) Max files open for normal shut down: 0 8) Program path: When the startup program is invoked in this way, a menu of programs is displayed. Pressing just RETURN, exits to BASIC. Entering "0" returns to the Catalyst menu. You may use the editor provided to add to this menu. The options available allow you to add, edit and delete entries from the menu. You may also select the prefix that will be used when the main program is exited by pressing just RETURN. Each entry in the menu consists of 3 items. Their meanings are discussed below. 1) Display name - A name consisting of from 1 to 34 characters that will be displayed as the program name in the startup program menu. If the first character of this name is an "*", the user will be prompted to install the program disk before the program is actually executed. 2) Prefix path - The prefix that will be set before the program is executed. If just RETURN is pressed here, the prefix will be left unchanged. 3) Program path - The path name of the program that will be run. If just return is pressed here, no program will be run. Only the prefix will be set and the startup program will be terminated. Operations on the menu are virtually identical to the corresponding operations you perform using the Catalyst Editor. Errors that may be encountered during operation of these programs are displayed as the flashing word ERROR in the lower left hand corner of the display followed by the text of the error. The error may be cleared out by pressing the ESCAPE key. For information on a specific error, refer to Appendix B. USING THE PASCAL STARTUP PROGRAM The Pascal versions of the startup program and the startup menu editor are virtually identical in operation to their BASIC counterparts. See the information above for details. The only major difference is that the "Initial prefix" should be set to DEFAULT. PROGRAMMING CONSIDERATIONS There are several special things that can be done using a system which has Catalyst installed. The first thing is that the programmer can disable the use of double apple ESCAPE even if its not disabled by Catalyst. This is done by opening CATALYST. As long as CATALYST is open, double apple ESCAPE is disabled. It is also possible to read the contents of the program path. To do this, you use a device status call to the Catalyst driver. A status call of 4 will return from 2 to 82 bytes. The first of these bytes is the number of times this status call has been used since the interpreter was started (255 max). The second byte contains the number of bytes in the program path string. The program path follows immediately thereafter. A status call of 55 can be used to determine the serial number of the Catalyst disk and the boot device. This call returns 18 bytes. The first two bytes are the serial number (low byte first). The next byte is the number of characters in the boot device's name. The name of the boot device follows immediately thereafter. APPENDIX A ERRORS & RECOVERY This appendix contains only errors that are particularly relevant to Catalyst. Other errors can occur. ERRORS DURING INITIAL BOOTUP These errors are reported during the initial phase of booting up the system. They all result in the failure of the boot process. BOOT DEVICE NOT FOUND The contents of the DCB of the .CATALYST driver do not correlate to a supported hard disk or the contents of the DCB do not reference a driver that is loaded. CATALYST DRIVER NOT FOUND The .CATALYST driver is not in the SOS.DRIVER file on the Catalyst disk. CATALYST LOAD FAILURE An unrecoverable error occurred while trying to load the Catalyst system. Open and then immediately close the drive door to see if it is a centering problem with the disk drive and then press CONTROL RESET to reboot. If the problem persists, contact your dealer. DRIVE NOT READY The hard disk used as the boot device is non-operational or is not up to speed. Try waiting until the drive is up to speed and then press RETURN. If this doesn't help, contact your dealer. I/O ERROR An error has occurred when Catalyst was trying to read information from your disk drive. Try rebooting Catalyst. If the problem persists, contact your dealer. SOS ERROR $dd The "dd" is a two-digit hexadecimal number which corresponds to an unexpected error from the SOS operating system. If you are concerned, record the number and report the failure to Quark. VOLUME NOT FOUND The hard disk cannot be properly read by Catalyst. Contact your dealer for assistance. ERRORS IN THE CATALYST MAIN MENU These errors occur when Catalyst is invoked via double apple ESCAPE or a quit from the interpreter. Some errors may also occur when an attempt is made to start a new program. If an error occurs immediately after pressing double apple ESCAPE, you can always return to the program you were running by pressing the ESCAPE key. BAD PATH NAMIE One of the path names for the program being started is improperly formed. Use the Catalyst Edit program to check the entry for that program. BAD FILE FORMAT An unexpected end of file was reached. BAD INTERPRETER The interpreter file specified for the selected program has been damaged, or is not actually an interpreter. Use the Catalyst Editor to check that the proper interpreter file has been specified. DISK FILES OPEN This is a warning that more than the maximum allowed number of disk files are open. If you actually change programs at this point, Catalyst will close these files. However, since Catalyst does not understand the reason that the files are open, this could be dangerous unless you understand exactly what the program is doing at the time. Pressing ESCAPE will return you to the program that was executing when the double apple ESCAPE was performed. (For some programs, having files opened at termination may be normal, however.) FILE BUSY This indicates that Catalyst has attempted to access the INTERPS file but that that file is currently being used by a program. This error will probably never occur. If it does, press ESCAPE to return control to the currently executing program. FILE NOT FOUND Someone has deleted (or removed or purged) a file which Catalyst requires. If the error occurs when a program is selected, one of the files needed to load that program is missing. Use the Catalyst Editor to determine which file is missing. If the error occurs immediately upon entry to Catalyst, the INTERPS file is lost. Recover an old copy of the INTERPS file from any backup you may have, or you may reboot the Catalyst disk and use the Catalyst Editor to recreate the file. FILE TABLE FULL Catalyst was unable to open any files since there were too many files already opened. Press ESCAPE to return to the program you were executing before you pressed double apple ESCAPE. Exit this program normally to allow it to close its files. I/O ERROR Some kind of error has been encountered while reading or writing information on the hard disk. This error is serious and may indicate a fault in the hard disk mechanism. Contact your dealer. INTERP TOO BIG An interpreter has probably been added to the Catalyst menu and the minimum interpreter load address was not recalculated. Use the update option in the Catalyst Editor to update the INTERPS file. Instruct it to recalculate the interpreter load address. After this is done, reboot the Catalyst disk. NO SUCH DEVICE Catalyst has been unable to locate the device specified in one of the pathnames for the program you are trying to load. Use the Catalyst Editor to determine the cause of the problem. SOS ERROR $dd The "dd" is a two-digit hexadecimal number which corresponds to an unexpected error from the SOS operating system. If you are concerned, record the number and report the failure to Quark. VOLUME NOT FOUND This error indicates that the specified volume could not be found. Use the Catalyst Editor to determine the cause of the problem. It may also indicate that your hard disk is not currently functioning. ERRORS IN THE CATALYST EDITOR Errors in the Catalyst Editor are signified by the presence of the flashing word "ERROR" in the lower left hand corner of the screen. The text of the error follows. The error may be cleared out by pressing the ESCAPE key. AVAILABLE DISK TABLE BAD The available disk table on one of your disks is bad. Contact your dealer for assistance. BAD INTERPRETER The diskette which is supposed to contain an interpreter contains a file which is improperly formatted. BOOT DRIVER NOT LOADED The .CATALYST driver does not appear to be loaded. You must use the System Configuration Program to correct the problem. CATALYST DISK NOT INSTALLED The disk that was installed was not the Catalyst disk. Repeat the operation and install the Catalyst disk properly. DIRECTORY ERROR The directory on one of your disks is damaged. Contact your dealer for assistance. DIRECTORY FULL No more entries can be added to the specified directory. DISK FULL ERROR You can this error while updating the INTERPS file. If the error occurs, an incomplete copy of the INTERPS file will be stored on disk. The last few entries in the Catalyst menu may be lost. Remove some unwanted files from your hard disk and use the Catalyst Editor to recreate the lost entries. DUPLICATE VOLUME ONLINE There are two or more disks installed with the same volume name. Remove any superfluous disks and try the operation again. FILE ALREADY EXISTS An attempt has been made to create a file that already exists. FILE IS LOCKED The file you are attempting to modify is locked. Unlock it (this can be done from BASIC, Pascal or System Utilities among other places). FILE NOT FOUND The specified file could not be found. This probably occurred because the name was improperly typed. IMPROPER FILE TYPE The file specified is not of the proper type. You have probably entered the wrong name. INSUFFICIENT MEMORY The Catalyst Editor cannot get sufficient memory to run properly. INTERPRETER PREVIOUSLY COPIED BY ANOTHER CATALYST The interpreter you are attempting to copy has been previously copied by a version of Catalyst with a different serial number. This interpreter belongs to that Catalyst and cannot be copied by another. INVALID PATHNAME The pathname for the file was probably improperly typed. NO SUCH DEVICE The device specified does not exist. The device name was probably mistyped. NOT ALL INTERPRETERS COULD BE ACCESSED This occurs when you recalculate the minimum interpreter load address in the update option (7). If not all interpreters can be found, the minimum load address may be inaccurate. NOT SOS DISKETTE The diskette was not formatted by the Apple /// (or was formatted in emulation mode). It is also possible that the diskette is damaged. PATH NOT FOUND The specified file was not found. The pathname for the file was probably improperly typed. SOS ERROR $dd The "dd" is a two-digit hexadecimal number which corresponds to an unexpected error from the SOS operating system. If you are concerned, record the number and report the failure to Quark. UNEXPECTED END OF FILE An interpreter file is improperly formatted. VOLUME NOT FOUND The volume specified could not be found. Possibly the volume name was mistyped. WRITE PROTECTED DISK A diskette on which the Catalyst Editor was trying to write has a write protect tab on it. If you really want to perform this operation, remove the write protect tab and repeat the operation. ERRORS IN THE BASIC STARTUP PROGRAM Errors in the BASIC startup program are signified by the presence of the flashing word "ERROR" in the lower left hand corner of the screen. The text of the error follows. The error may be cleared out by pressing the ESCAPE key. BAD INVOKE The CATALYST.UTIL file has been destroyed. BAD PATH The pathname for the file was probably improperly entered. Use the BASIC Menu Editor to determine the cause of the problem. FILE NOT FOUND The specified file could not be found. This probably occurred because the name was improperly typed. Use the BASIC Menu Editor to determine the cause of the problem. FILE TYPE MISMATCH The specified file is not a BASIC program file. It could also mean that the wrong CATALYST.UTIL file is stored on disk. NOT SOS DISK The diskette was not formatted by the Apple /// (or was formatted in emulation mode). It is also possible that the diskette is damaged. PATH NOT FOUND The specified path could not be found. This probably occurred because the name was improperly typed. Use the BASIC Menu Editor to determine the cause of the problem. VOLUME NOT FOUND The volume specified could not be found. Possibly the volume name was mistyped. Use the BASIC Menu Editor to determine the cause of the problem. ERRORS IN THE PASCAL STARTUP PROGRAM The Pascal startup program generates Pascal error codes. Refer to your Pascal programmer's manual for details. APPENDIX B DRIVER CONFIGURATION BLOCKS CONFIGURATION BLOCK FOR QUARK'S .CONSOLE DRIVER The .CONSOLE driver that must be used with Catalyst has a single byte in its configuration block that is used to selectively disable the CONTROL keypad keys (see pages 56 thru 58 of the Standard Device Drivers manual for an explanation of these keys). The following values or value ranges for the byte in the configuration block have these effects: 00..B5 All special keys disabled. B6 Only CONTROL 5 (screen toggle) enabled. B7 Only CONTROL 5 and 6 (flush type ahead buffer) enabled. B8 Only CONTROL 5, 6 and 7 (Screen output suspend) enabled. B9 Only CONTROL 5, 6, 7 and 8 (Display control characters) enabled. BA..FF All special keys enabled. Note: For Word Juggler use B7. For "normal" console operation use FF. CONFIGURATION BLOCK FOR QUARK'S .PRINTER DRIVERS The configuration blocks for the serial and parallel printer drivers are the same as their corresponding Apple equivalents. The description of the configuration block for the serial printer driver is given in Appendix C of the Standard Device Drivers manual. The description of the configuration block for the parallel printer driver is given on pages 19 thru 22 of the Universal Parallel Interface Card Installation and Operating Guide. CONFIGURATION BLOCK FOR THE .CATALYST DRIVER There are 6 bytes in the configuration block of the .CATALYST driver. The ONLY one which should be modified by the user is the first byte (Byte 00). This should be set to the number of the slot containing the ProFile drive (generally 4). Do not modify other bytes except as specified in the following section. SETTING UP .CATALYST FOR DIFFERENT HARD DISKS Only certain disk drives are supported by Catalyst. Additional drives are added to the list from time to time. If you do not see your drive listed below, you may be unable to use this version of Catalyst with your hard disk. Contact Quark and the manufacturer of your drive to check on availability of support from Quark. To adapt Catalyst to use your hard disk drive, you must change the DCB of the .CATALYST driver. The first byte (byte 00) of the DCB should be set to the slot number in which the drive is installed. The bytes (numbered 00 through 05) should be set as follows (0s stands for slot number): DEVICE MANUFACTURER DCB (Bytes 00 through 05) ProFile Apple 0s 00 D1 01 01 00 APPENDIX C FILE FORMATS FORMAT OF THE 'INTERPS' FILE The INTERPS file is the file which contains the list of interpreters that is used by Catalyst. INTERPS is a BASIC text file (Pascal ASCII file) which must be stored in the root directory of the boot device. The file is stored as "lines". Each line is a sequence of printing characters followed by a carriage return. Thus, a simple BASIC or Pascal program can readily read the INTERPS file. The first line in the file describes whether the date should be requested at boot time or not. It also describes which interpreter will be started at boot time. The precise form of the line is: tdd The "t" is time/date request code. "A" indicates that the date and time are always requested. "S" indicates that date and time are requested only if unknown. "N" indicates that the date and time are never requested. Any character other than "A", "S" or "N" is taken as "A". "dd" is a 2-digit decimal number which specifies the number of the start interpreter. For numbers smaller than 10, a leading zero is present. A "00" indicates that no interpreter will be automatically started. If the number is improperly formed, a "00" will be assumed. After the initial line, there is a group of 8 lines for each interpreter. Their definitions are as follows: 1) The name displayed for an interpreter in the menu (13 characters max). 2) The pathname of the character set (null indicates the default set). 3) The character set inverted flag ("N" for normal, "I" for inverted). 4) The pathname for the keyboard (null indicates default keyboard). 5) The pathname for the interpreter. 6) The initial prefix (null indicates the root directory of the boot device). 7) Allowable file open count (a one digit number or an "*"). 8) Program path. Accessible to the interpreter via a status call to .CATALYST. If the length of any line exceeds 79 characters, all characters after the 79th are ignored. In the event that the display name (1) exceeds 13 characters, only the first 13 are significant. Unless the first character of the character set inversion flag is a "I", normal is assumed. If the Allowable file open count is not a digit, "*" is assumed. Catalyst performs virtually no file type checking on the character set, keyboard, or interpreter file. In the case of an interpreter file, however, certain information contained in the file is checked for validity. The allowable file open count is used by Catalyst to determine whether the "DISK FILE OPEN" warning should be issued when Catalyst is invoked. If more than the indicated number of block files are open, the warning is produced. FORMAT OF THE BASIC AND PASCAL MENU FILES The menu file used by the BASIC startup program is called BASIC.HELLOS and resides in the CATALYST subdirectory. The menu file used by the Pascal startup program is called PASCAL.STARTS and resides in the root directory of the boot device. Both files have the same format (almost). The Pascal file, however, has an extra carriage return appended to the end of the file. The file is stored as "lines". Each line is a sequence of printing characters followed by a carriage return. Thus, a simple BASIC or Pascal program can readily read the menu files. The first line in the file specifies the prefix that will be set if the startup program is exited by a simple RETURN. If the line is null, the prefix will be left untouched. The remainder of the file is groups of three lines. The meaning of each line is as follows: 1) The display name of the menu entry (1 to 34 characters). If the first character is an "*", the user will be prompted to insert the disk with this name before this program is actually run. 2) The prefix to be set. A null line leaves the prefix unchanged. 3) The program to run. A null program name simply terminates the startup program. Copyright information: If you wish to use any images on these pages, please contact the author, Phil Beesley on beesley@mandrake.demon.co.uk.