FaccII Installation (Long Form) 1.0 Introduction This document describes the steps required in properly and fully installing FaccII. This document does not describe how FaccII (or its user interfaces) are used. 1.1 Notice FaccII, its documentation, and all associated programs are copyrighted (1987 by ASDG Incorporated) and represent proprietary material protected by local, state and federal statutes. Copies may be made by the purchaser for sole use by the purchaser on exactly one Amiga (trademark Commodore-Amiga Inc.) computer. Any duplication by any means or distribution to anyone other than the purchaser constitutes theft and shall surely be prosecuted to the fullest extent of the law. Not to mention the fact that you'd be cheating others out of their future upgrades. 1.2 The Parts The cast of characters includes: 1. FaccII. This is the main program which actually performs all of the disk magic. This is found in the Programs subdirectory. We suggest that you copy it to your System directory (with its icon) or to your C directory (without its icon). 2. Facction. This is the expanded FaccII User Interface. This program allows total access to all FaccII features and capabilities via a windowed interface or from the CLI. This program is located in the Programs subdirectory. We suggest you copy it to your System directory (with its icon) or to your C directory (without its icon). 3. SatisFacction. This is an alternate FaccII User Interface which provides limited access to the features and capabilities of FaccII. It is designed to emulate the operating characteristics of the original Facc program. This program is located in the Programs subdirectory. We suggest you copy it to your System directory (with its icon) or to your C directory (without its icon). Copyright 1987 1 By ASDG Inc. FaccII Installation (Long Form) 4. ASDG-Low-Mem.Library. This is an optional part of the FaccII program. It must be located in your LIBS: directory for FaccII to find it. FaccII will work if this library is not present but some features (pertaining to low memory detection) will not be usable. 5. RunBack. This is a public domain program by Rob Peck. It is used to launch FaccII from the startup-sequence yet still allow the original CLI to exit. You should put this program in your C directory if you want to start FaccII from the CLI. 6. FastMem. This is an added bonus. It will aternately disable/enable any fast ram that you might have so that older programs which were written improperly (eg: will not work in the presence of fast ram) may work. Copy this to your System drawer (with icon) or your C directory (without icon). 7. Sysmon. This is an added bonus. It will display a lot of useful information about your machine like memory and cpu utilization. Copy this to your System drawer (with icon) or your C directory (without icon). 2.0 Installing FaccII 2.1 Under All Circumstances First, make sure your FaccII distribution disk is in its write protected state. Do this by visually inspecting the write protection tab located on the diskette. Second, there are several paths you may take to installing FaccII. For all of these you should copy the ASDG-Low-Mem.Library to your Libs: directory. This will enable several interesting features of FaccII. But be aware that the library does not have to be present for FaccII to work. If the library is not present some advanced features of FaccII won't be available. To copy the library over to your Libs: directory you should insert the FaccII distribution disk into one of your disk drives. If you have only one disk drive then you've probably had enough experience to perform the file copy with only one drive. One thing you might need to know is that the copyright sign in the name of the FaccII distribution disk is obtained by striking the ALT key WITH the letter ``e''. Copyright 1987 2 By ASDG Inc. FaccII Installation (Long Form) If you have more than one drive and have inserted the FaccII distribution disk into drive X, then in the CLI say: copy DFX:Libs/#? Libs: The system should print: DFX:Libs/asdg-low-mem.library..copied This completes the installation of the Low Memory Server for multidrive systems. For a single drive system, enter the CLI and say: copy FaccII(ALT+E)ASDG:Libs/#? Libs: Note that the (ALT+E) above means that you should strike the ALT key and the letter ``e'' together. The system should respond with a message saying that the library has been copied (after you swap disks, that is). 2.2 Installing FaccII For WorkBench Or CLI Usage If you wish to run FaccII from the WorkBench you will have to copy the FaccII programs and their icons to a drawer on your system disk which is already WorkBench capable. For example, the System drawer is a good candidate while the C directory is not. This is because the System drawer has a drawer icon while the C directory does not and thus cannot be accessed from the WorkBench. From within the WorkBench, double click the left mouse button over the FaccII disk icon. This will result in a window showing three drawers plus a miscellaneous icon. One of these drawers should be called ``Programs''. Double click the left mouse button over the Programs drawer. This should result in a window containing five program icons. Three of these constitute FaccII. By double clicking the appropriate icons, bring the window describing the drawer you wish to copy FaccII to up on the screen. For example, double clicking on your WorkBench disk and then the System drawer icon will make your System directory ready to accept FaccII. Drag (by depressing and holding the left mouse button over the appropriate icon) the FaccII program over to your desired destination drawer (for example, your System drawer). When you Copyright 1987 3 By ASDG Inc. FaccII Installation (Long Form) release the left mouse button some disk activity will take place. When it finishes you should see the FaccII program icon materialize in the destination window. Next you may repeat the above procedure with either Facction or SatisFacction or both. Facction and SatisFacction are both user interfaces to FaccII. SatisFacction is a small subset of Facction designed to emulate the user interface that the original Facc program presented. If you want full access to all the new features of FaccII then drag over Facction. If you need only a simple user interface than SatisFacction would be appropriate. Note: Only Facction has a CLI (Command Line Interface) capability. SatisFacction can only be used in its windowing form. If you want to control FaccII directly from the CLI then you will need Facction. Since you now have the capability of launching FaccII from the WorkBench you do not have to copy RunBack to your C directory. If FaccII is ``run'' from the CLI, the invoking CLI will not disappear when you command it to with an ``endcli'' until all of processes started from it with ``run'' commands themselves exit. The public domain program RunBack is provided if you would like to launch FaccII from the CLI and have the invoking CLI be able to exit at will. Note that launching FaccII from the WorkBench sidesteps this entire issue. 2.3 Installing FaccII For CLI Usage ONLY If you intend to use FaccII and its user interface from the CLI ONLY then you have no need of the icons that come with the program for use under the WorkBench. Also, instead of going in the System drawer, you'll probably want to put the FaccII programs and user interfaces in the C directory along with your other commands. To do this, copy FaccII and either or both of Facction and SatisFacction to your C directory. The copy is performed in a similar manner as was described above. See the note in the previous section concerning the difference between Facction and SatisFacction. You should also copy the public domain program RunBack from the C directory of the FaccII distribution disk to your own C directory. Copyright 1987 4 By ASDG Inc. FaccII Installation (Long Form) And finally, here's some example startup-sequence code: if exists c:FaccII if exists c:RunBack RunBack -5 c:FaccII else run FaccII if exists c:Wait Wait 5 endif endif endif if exists c:Facction Facction -n 512 endif Example Startup-Sequence Code Notice that the existence of FaccII, RunBack and Wait are tested before they are actually invoked. If FaccII is in your C directory and RunBack is there as well, then RunBack will be used to launch FaccII. If RunBack is not found but FaccII is, then Run will be used to launch FaccII. Also note that a full pathname is needed by RunBack. That is, RunBack will not search the C: directory as the CLI does. Since the startup-sequence is not based within the C: directory you *must* specify ``c:FaccII'' for RunBack to find FaccII. If you had copied FaccII to a directory other than C: than that path must be specified. After FaccII is running (for the purposes of this example), we invoke Facction taking advantage of its CLI interface. This execution of Facction will not produce a window on the screen and will in fact terminate as soon as it has instructed FaccII to use 512 buffers (instead of the default 256). The ``-5'' option to RunBack and the call to Wait if RunBack is not available is to cause the system to pause while FaccII is fetched from the floppy. Without this delay disk thrashing will slow down the loading of FaccII considerably (this sort of thrashing is substantially reduced by the normal operation of Facc and FaccII). 2.4 Installing SysMon And FastMem SysMon, the system monitor can be run from the CLI or from the WorkBench. If you desire to run it from the WorkBench, drag its icon to the System drawer as you had before. Same goes for FastMem. If you want to run these programs from the CLI only Copyright 1987 5 By ASDG Inc. FaccII Installation (Long Form) then these programs are suitable for copying to the C directory. 3.0 Summary Decide if you want to be able to run FaccII from the WorkBench. If you do, then you'll be copying the FaccII programs using the WorkBench to a drawer like System. By putting the System directory on your ``path'' you can also use the FaccII programs from the CLI. If you want to be able to run the FaccII programs from the CLI only then using the CLI copy the FaccII programs to your C directory. Also, if you wish to launch FaccII from the CLI we strongly suggest you copy the public domain program RunBack from the C directory on the FaccII distribution disk to the C directory on your own disk. In either case you should copy the ASDG-Low-Mem.Library from the Libs: directory on the FaccII distribution disk to the Libs: directory on your system disk. Copyright 1987 6 By ASDG Inc. FaccII Installation (Long Form) Contents 1.0 Introduction........................................... 1 1.1 Notice.............................................. 1 1.2 The Parts........................................... 1 2.0 Installing FaccII...................................... 2 2.1 Under All Circumstances............................. 2 2.2 Installing FaccII For WorkBench Or CLI Usage........ 3 2.3 Installing FaccII For CLI Usage ONLY ............... 4 2.4 Installing SysMon And FastMem....................... 5 3.0 Summary................................................ 6 Copyright 1987 7 By ASDG Inc.