README File for JSIM

The JSIM License

The JSIM license is a BSD-style license.

Download the tar file (JSIM.tar)

4612931 Jan 28 04:50 JSIM.tar

Installing JSIM

tar zxvfp JSIM.tar

Updating your Environment (UNIX)

(e.g., in .login or .cshrc files -- adjust as needed)

setenv JAVA_HOME $HOME/java/jdk1.6.0
setenv JSIM_HOME $HOME/JSIM
setenv CLASSPATH $JSIM_HOME/.:$CLASSPATH

Updating your Environment (LINUX)

(e.g., in .bashrc files -- adjust as needed)

export JAVA_HOME $HOME/java/jdk1.6.0
export JSIM_HOME $HOME/JSIM
export CLASSPATH $JSIM_HOME/.:$CLASSPATH

Adding JSIM to your path

(directories to search for executable files, e.g., see .cshrc or .bashrc)

$JSIM_HOME/bin

Building JSIM

The JSIM build uses Apache ANT 1.6.2. The instructions below assume that ANT is installed.

cd JSIM
ant -buildfile JSIMBuild.xml compile

Let's now assume you are starting from your JSIM home directory.

Running the Model Designer

The steps below will open and generate the Bank example in the using the JSIM designer.

cd examples/bank
ant -find Designer.xml
-- select the "Open" option on the file menu
-- enter Bank.jm as the file name in the open dialog box
-- click the "Apply" button on the open dialog box
-- click "Generate" button and then on the canvas

More information on using the JSIM designer can be found in the Manual.htm file.

Running Example Model Applications

The steps below will compile and execute the Bank example.

cd examples/bank
ant -find ModelBuild.xml
java Bank

More information on executing JSIM models can be found in the Manual.htm file.

Creating the JSIM API Documantation

cd JSIM

ant -buildfile JSIMBuild.xml doc

The api documentation will be placed in the JSIM/doc directory.

Known Bugs

Edges cannot be deleted in the graphical designer.
Signal nodes do not work correctly when used with facility nodes.
The designer does not generate models correctly when signal nodes are used.
In some cases the designer encounters a serialization error when attempting to load saved models.