JLS is contained in a JAR (Java ARchive) file. It can be run from a command line, or, depending on the operating system and window manager, by clicking on an icon. It runs in one of two modes: interactive (with GUI) or batch (no GUI). Interactive is the default. Use the -b flag (see below) to run JLS in batch mode.
When run in the interactive mode, JLS will create a checkpoint file after every 10 changes. The name of the checkpoint file is the name of the circuit with ".jls~" appended. If JLS aborts and you are not able to save the circuit you are working on, then you can recover the checkpointed state by renaming the checkpoint file (delete the "~") and starting JLS again.
The basic command for starting JLS in interactive mode is:
java -jar JLS.jar
This starts up JLS with no circuit in the editor.
The user can subsequently create a new circuit or open an existing circuit.
If a circuit file name is specified on the command line then JLS will start up with the circuit already loaded in the editor, e.g.
java -jar JLS.jar circuit.jls
To run JLS in batch mode type
java -jar JLS.jar -b circuit.jls
(note that a circuit file must be specified when -b is used)
The mechanism for starting JLS by clicking on an icon is dependent on the particular operating system and window manager. While the details differ, most allow the icon to be parameterized in such a way as to allow the various command line options to be specified.
-b Batch mode.
-dtime Set the simulation time limit. The time is a positive integer immediately following -d, e.g., -d1000.
-h Print a short help message.
-sname Read JLS start-up file before loading any circuits. The name of the file immediately follows the -s, e.g., -sparameters. Any legal file name not containing spaces is allowed.
-tname Read JLS test input file just before simulating a circuit. The file will be read every time the simulator is started, so changes made to the file will affect a subsequent simulation run. The name of the file immediately follows the -t, e.g., -tinputsigs. Any legal file name not containing spaces is allowed.
-pprinter When used with batch mode causes the entire circuit to be printed. If a printer name is present, the output will be sent to it.
-vprinter When used with batch mode causes the top level of the circuit to be printed (no subcircuits). If a printer name is present, the output will be sent to it.
-rprinter Forces batch mode, runs the simulator, and prints the signal trace to the named printer.