JAMS Start

Starting JAMS

Starting JAMS can be done in two ways:

1. Executing the file jams.exe (jams for Linux) in the JAMS installation directory
2. Executing JAVA in the JAMS installation directory by indicating the JAMS archive: java -jar lib/JAMS.jar

The second option is suitable if a different file than that in the installation package is to be used or if the file jams.exe does not exist. The direct call of Java also makes it possible to transfer additional parameters to the virtual machine and to show the entire output of JAMS including error messages. An example of indicating additional parameters is presetting the initial and maximum memory space, which is available when executing JAMS. 300MB as initial space and 500MB as maximum can be reserved by using the following call:

java -Xms300m -Xmx500m -jar lib/JAMS.jar

JAMS Command Line Argument

Beim Start von JAMS können folgende Kommandozeilenargumente verwendet werden:

1. -h/--help : Liste aller Kommandozeilenargumente
2. -c/--config <config file name> : Angabe einer Systemkonfigurationsdatei
3. -m/--model <model file name> : Angabe einer Modelldefinitionsdatei
4. -p/--parametervalue <list of parameter values> : Angabe einer Semikolon-separierten Liste von Parameterwerten.

Ein typischer Start von JAMS mit direkter Angabe der Modellkonfigurationsdatei könnte somit wie folgt aussehen:

java -jar lib/JAMS.jar -m JAMS-Gehlberg/j2k_gehlberg.jam

Modellparameter beim JAMS-Start übergeben

Das Kommandozeilenargument -p/--parametervalue erlaubt die Angabe einer Semikolon-separierten Liste von Parameterwerten (z.B. "0.1;7;1996-11-01 7:30 2000-10-31 7:30 6 1"). Die Zuordnung dieser Werte zu Modellparametern in JAMS erfolgt dabei über ihre Position in der Liste. Dazu müssen in der Modellkonfigurationsdatei Platzhalter an denjenigen Stellen eingefügt werden, an denen die übergebenen Parameterwerte eingefügt werden sollen. Diese Platzhalter haben die Form "%x", wobei x eine bei 0 startende, fortlaufende natürliche Zahl ist. Im Beispiel

java -jar lib/JAMS.jar -m JAMS-Gehlberg/j2k_gehlberg.jam -p "0.1;7;1996-11-01 7:30 2000-10-31 7:30 6 1"

würde in j2k_gehlberg/j2k_gehlberg.jam dann der Platzhalter "%0" durch "0.1", der Platzhalter "%1" durch "7" und der Platzhalter "%2" durch "1996-11-01 7:30 2000-10-31 7:30 6 1" ersetzt werden.

Auf diese Weise ist es leicht möglich, Modellparameter bereits beim JAMS-Start mit vorgegebenen Werten zu versehen, was beispielsweise bei der Batch-Prozessierung von Simulationsläufen erforderlich ist.