Iniciando o JAMS

Revisão das 20h42min de 11 de Junho de 2013

Iniciando o JAMS

O JAMS pode ser iniciado de duas maneiras:

1. Executar o arquivo jams.exe (Jams para Linux) no diretório de instalação JAMS
2. Executar JAVA no diretório de instalação do JAMS indicando o arquivo JAMS: java-jar lib/JAMS.jar

A segunda opção é adequada, se um arquivo diferente do que no pacote de instalação dever ser usado ou se o arquivo jams.exe não existir. O comando direto do Java torna possível transferir parâmetros adicionais para a máquina virtual e mostrar todo o produto do JAMS, incluindo mensagens de erro. Um exemplo para indicar parâmetros adicionais é a pré-configuração do espaço de memória inicial e máximo, que ficam disponíveis ao executar-se o JAMS. Como o espaço inicial e máximo 300MB e 500MB podem ser reservados respectivamente através do seguinte comando:

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

JAMS Argumento de linha de comando

Ao iniciar-se o JAMS os seguintes argumentos de linha de comando podem ser usados:

1. -h/--help: Lista de todos os argumentos de linha de comando
2. -c/--config <config file name>: indicando um arquivo de configuração de sistema
3. -m/--model <model file name>: indicando um arquivo de definição de modelo
4. -p/--parametervalue <list of parameter values> : indicando uma lista de parâmetros, separados por ponto-evírgula.

Um início típico de JAMS usando uma indicação direta de um arquivo de configuração do modelo poderia ser a seguinte:

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

Transferindo parâmetros de modelos ao iniciar-se o JAMS

O argumento de linha de comando -p/--parametervalue permite uma indicação de uma lista separada por ponto-e-vírgula de valores dos parâmetros (por exemplo, "0,1;7;1996-11-01 07:30 2000-10-31 07:30 6 1"). A atribuição de valores para os parâmetros do modelo é feita pelo JAMS em sua posição na lista. Para este efeito, caracteres especiais têm de ser inseridos no arquivo de configuração do modelo nas posições em que os valores dos parâmetros a serem transferidos são inseridos. Esses caracteres universais têm a forma "%x", em que x é um número consecutivo natural a partir de 0. No exemplo

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"

o curinga "%0" seria substituído por "0.1", em seguida "%1" por "7" e "%2" por "1996-11-01 7:30 2000-10-31 7:30 6 1" em j2k_gehlberg/j2k_gehlberg.jam.

Desta forma, é facilmente possível atribuir dados valores aos parâmetros do modelo ao se iniciar o JAMS: tal como exigido no processamento em lote de execuções de simulação.