READ THE FAQ This document includes the bare basics needed to get started. However, once you've installed Executor, you should read the file "docs\faq". It contains answers to Frequently Asked Questions. EXECUTOR 2: COMMERCIAL SOFTWARE This directory contains Executor 2, a Macintosh emulator for PCs. This software is copyrighted by ARDI, and is not sold, but is licensed for use. The license does not allow this software to be posted on a bulletin board or otherwise made available for electronic copying. There is a demo version of Executor 2 that may be electronically redistributed under some circumstances, but that is an entirely different program. MORE INFO In addition to the text files in the doc subdirectory mentioned above, another good source of information about Executor is the Usenet newsgroup "comp.emulators.mac.executor", or the Executor interest mailing list. The newsgroup and the mailing list are connected via a bidirectional gateway. To join the mailing list, send e-mail to "executor-request@ardi.com" or "executor-digest-request@ardi.com" with a blank subject line and a body that says "subscribe". With the first address, you'll receive e-mail everytime someone sends anything to the mailing list. With the digest form, you'll receve e-mail only once a day with all the previous day's traffic bundled into one digest. You can then send messages to the entire group by sending to "executor@ardi.com". DISABLE DISK WRITE CACHING WHEN USING EXECUTOR If you are using disk cacheing you should set it to ONLY do READ caches. Write caches can result in the ".hfv" files being corrupted if Executor dies unexpectedly. (NOTE: if you forget to turn off your write cache, you may have to reinstall the ".hfv" files after Executor crashes). EXECUTOR NEEDS A MOUSE DRIVER TO WORK In addition to needing a mouse to be physically connected to your computer, Executor requires a mouse driver to be loaded before it can run. If Executor complains that you don't have a mouse installed, even though you have one connected, the problem is that your autoexec.bat does not load the mouse driver for use with DOS programs. Since many people only use their mouse with Windows, which has its own mouse driver, they don't have the mouse driver commands in their autoexec.bat. The exact changes that need to be made to your autoexec.bat varies depending on what type of mouse you have, and where the mouse driver has been installed on your system. In general, anyone knowledgeable about your particular configuration should be able to give you simple instructions for modifying your autoexec.bat, whether that's the technical support line of the company that made the machine, or your local DOS wizard. HOW TO GET STARTED COPYING MACINTOSH FORMATTED FLOPPIES Executor/DOS can only read High Density (1.4 MB) formatted floppies. Most older Macintosh applications were distributed on 800K floppies which can't be used with Executor, so MAKE SURE you use 1.4 MB Macintosh formatted floppies with Executor/DOS. Executor/DOS doesn't low format floppies for you, but it will reformat a DOS floppy as a Macintosh floppy, but only if you insert the floppy into the floppy drive *after* Executor has brought up its desktop. It is important to note that you have three different areas that you can copy to/from. In addition to Macintosh formatted floppies, you can copy Macintosh files to your hard disk, either as DOS files, or as Macintosh files within a single DOS file which represents a Macintosh "volume". Executor/DOS 1.99 also allows you to copy to/from Mac formatted SCSI drives (if you have a SCSI adapter) and copy from Mac formatted CD ROMs if you have a CD ROM drive (must be seen as drive H: or lower). When you copy Mac files as DOS files, they are broken up in two halves. One half will have the original name of the file, the other will have a "%" prepended to the original name. The file with the original name represents the "data fork" of the Macintosh file, and that's where data that can be used in both Macintosh and DOS environments resides. The other half, the one with the "%" prepended is the "resource fork" and it contains information that only makes sense in the Macintosh environment. Using the DOS filesystem to represent Macintosh files is very awkward. In fact, if the names contain funny characters, you might get an "I/O error". The alternative is to store files within a single "Macintosh Volume". This demo version of Executor comes with a 4 MB Mac Volume. It should be sufficient to allow you to explore Executor. While Executor is working within a Macintosh volume, files can have upper and lower case names with lengths up to 31 characters, but your DOS programs can't see the individual files. More about what's going on is in the printed documentation. USING MAKEHFV TO CREATE A NEW VOLUME Although we don't supply documentation with this demo version of Executor, you may notice the "MAKEHFV" program in the "\EXECUTOR" directory. If you are adventurous and want to use makehfv, it is important that the new volume that you create have the suffix ".HFV". If you do not call your new volume "something.HFV", Executor will ignore it. RUNNING PROGRAMS DIRECTLY OFF FLOPPIES IS SLOW Running programs directly off floppies is incredibly slow. You will find it much quicker to use HFS_XFer to copy a program from a floppy into one of your ".hfv" files and then run the program directly out of the ".hfv" file. UNIXISMS LEFT IN EXECUTOR Executor was developed originally under UNIX. A few "UNIXisms" have remained in Executor. Sometimes you will see "/" used where "\" would normally be used in DOS. In addition, switches are introduced with a leading "-" instead of "/". We apologize for this annoyance. USE WITH WINDOWS Executor/DOS 2 will run under Windows 3.1. You can make a double-clickable icon for Executor by using the Program Manager in Windows: Choose "New..." from the Program Manager "File" menu Click the "Program Item" radio button Click "OK" Enter "Executor" in the Description field Enter "c:\executor\executor" in the Command Line field Enter "c:\executor" in the Working Directory field Add a Shortcut Key if you wish Click on "Change Icon... Click on "OK" when the error message comes up Find, Select and Click OK on an Icon you like Click on "OK" to leave "Program Item Properties" Remember, Executor is its own windowing system. It does not need Windows to be effective, although the only way you can run two Mac programs at once it to do so under Windows. Once you have one copy of Executor running under Windows, you can use "Left_Alternate-Tab" and "Right_Alternate-Enter" to hot-key back and forth between different programs and screen modes. USE WITH OS/2 Executor/DOS 1.99 works with OS/2 2.11, but not with previous versions. To get E/D 1.99 to run you'll need to adjust use these settings: DPMI_DOS_API ENABLED DPMI_MEMORY_LIMIT 16 EMS_MEMORY_LIMIT 0 XMS_MEMORY_LIMIT 0 USE WITH NT Executor must be started from a FULL-SCREEN DOS session in order for it to work properly under Windows NT. Executor running under NT will be able to access Mac formatted HD diskettes but will not be able to access Mac formatted hard drives or CD-ROMs. NT 4.0 runs Executor 2 much better than NT 3.x. IF EXECUTOR RUNS SLOWLY Executor needs about 8 MB of memory to work efficiently. If it does not have enough physical memory, it will make do by writing infrequently used parts of itself to your hard disk and only "paging" them in when they're actually used. However, DOS systems can have their memory artificially eaten up in too many ways to describe here. If think Executor is running slowly, you might want to have a DOS guru check to make sure that it's not being memory starved. A NOTE ABOUT CD-ROMS Executor 2 needs to use the 16-bit version of MSCDEX in order to read raw CD-ROM sectors. If Executor 2 can't read raw CD-ROM sectors, it can't interpret Macintosh CD-ROMs. If you are running Windows '95, you may need to consult a Windows '95 guru to show you how to configure your system so that you're using the 16-bit version of MSCDEX instead of the 32-bit version. This limitation will disappear in future versions of Executor. Thanks you for purchasing Executor 2. Clifford T. Matthews Founder ARDI How to contact ARDI: Web: http://www.ardi.com e-mail: info@ardi.com Usenet: comp.emulators.mac.executor FAX: +1 505 766 5153 Phone: +1 505 766 9115