1. You must have Java Runtime Environment on your system. If you do not already have it on
your system go to the Java directory on the CD and double click the
jre-6u31-windows-i586-s.exe file located there to start the installation.
2. You need to install the Hercules emulator.
For Windows: Go to the Hercules directory on the CD and double
click the 32 or 64 bit installer located there.
For Linux: Extract the file hercules-3.07.tar.gz in the Hercules directory on the CD
to a convenient location on your hard drive. You will need several packages
in addition to the standard build packages. On Ubuntu these can be had with
the following commands:
sudo apt-get install gettext
sudo apt-get install zlib1g-dev
sudo apt-get install libbz2-dev
From the source directory the commands to build are:
./configure --enable-external-gui --enable-cckd-bzip2
sudo make install
3. The CD contains a directory called myDOSVS which holds all the files for myDOSVS.
This directory needs to be copied to a convenient location on your hard drive.
In general you should not place this directory in a path that has spaces in the name.
The standard Windows location "Program Files" is acceptable as the program will reference
it using the short name "PROGRA~1" which does not contain spaces. You should check the
permissions after copying the directory. At least the owner needs full control access.
4. To start the program:
Windows - Go to my computer and navigate to the myDOSVS directory. Double click on the
myDOSVS.jar file. You may create a shortcut to this file on your desktop if
Linux - Open a terminal and navigate to the myDOSVS directory. Start the program with:
java -jar myDOSVS.jar
5. The first time the program starts you will be presented with a dialog box asking for the location
of the Hercules executable file, the location of the myDOSVS directory, and the location of the java
executable. When you click the Ok button the program will verify your response and wait for a
correction if it cannot find the files.
You may wish to view the general guide to myDOSVS operation or proceed
directly to starting the system.