JAMS Start

JAMS starten

Der Start von JAMS kann auf zwei Wegen erfolgen:

1. durch Ausführen der Datei jams.exe (jams für Linux) im JAMS-Installationsverzeichnis
2. durch Ausführen von JAVA im JAMS-Installationsverzeichnis unter Angabe des JAMS-Archivs: java -jar lib/JAMS.jar

Die zweite Möglichkeit ist geeignet für Fälle, in denen eine andere als die im Installationspaket vorhandene JAVA-Installation verwendet werden soll oder wenn die Datei jams.exe nicht existiert. Bei diesem direkten Aufruf von JAVA können darüber hinaus zusätzliche Parameter an die virtuelle Maschine übermittelt und sämtliche Ausgaben von JAMS einschließlich Fehlermeldungen eingesehen werden. Ein Beispiel für die Angabe zusätzlicher Parameter ist die Voreinstellung des initialen und maximalen Speicherplatzes, welcher bei der JAMS-Ausführung zur Verfügung steht. Eine Reservierung von initialen 300MB und maximalen 500MB Speicherplatz kann so etwa mit folgendem Aufruf sichergestellt werden:

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

JAMS Kommandozeilenargumente

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.