@author Fuat Keceli
@exc Java executable Last update: Jul 03, 2008
@doc User's Manual  Last update: Jul 03, 2008
@doc DESim API  Last update: Jul 03, 2008
@src Source files Last update: Jul 03, 2008
@doc Compressed full package (size: 248K)  Last update: Jul 03, 2008
@version 

Document last updated on: Jul 03, 2008 (document version: )

This document explains how to install and run DESim. Discrete Event Simulator
(DESim) is a general-purpose discrete event simulation environment and an
associated command prompt tool developed in Java. Download DESim here.

DESim requires Java SDK to be installed on your local computer. Minimum
requirement and suggested Java version is 1.4.2. IMPORTANT: If you only
have Java Runtime Environment (JRE), you won't be able to create your
own simulation inputs. To check your Java version and java environment
type:

1. Open a terminal/command prompt window (in Windows XP, go to Start Menu/Run,
   type "cmd" and press enter).

2. Type "java -version" and press enter. Make sure that the displayed version
   number meets the minimum.

3. Type "javac -help" and press enter. Make sure that the system can find the
   command.

If you encounter an error in steps 2 and 3, you probably need to install Java.
You can download Java SDK here. If you are using WindowsXP,
and still getting errors, the problem might be the path variable. You have to
add <java-installation-dir>/bin to the PATH variable so that the command prompt
can find java executables. The command is as follows:

set PATH=<java-installation-dir>\bin;%PATH%

An example of java installation directory is "C:\j2sdk1.4.2_06".

If you completed all three steps successfully, you can proceed to running
your first example (if you haven't downloaded DESim yet, download here):

1. Create a new directory and move DESim java executable - DESim.jar to the
   new directory.

2. Download the example MM1.java in the same new
   directory. This example is explained in the User's Manual.

3. Open a terminal window (command prompt) and change the directory to the new
   directory.

4. Compile the input file:
     > javac -classpath DESim.jar;. MM1.java

5. Run the example:
     > java -classpath DESim.jar;. DESimulator.DESim MM1 5

The example should run until 5 jobs are completed and print out the following:

Time: 24.26698076644753
Completed: 5
Counted for termination: 5

Average waiting time: 0.0
Average process time: 1.5971188121574267
Server utilization: 0.3290724189235904
Average queue size: 0.0