Starting JMARS


Starting JMARS from the Command Line

  1. For Public and External Users
Change to the directory with the jmars.jar file (which you have already downloaded) and type:
>java -jar jmars.jar
If you would like to open jmars from a diffent directory, you can replace "jmars.jar" with "path/jmars.jar".

  1. For Internal Users
Open a terminal window and type:
>jmars


Starting JMARS with Additional Arguments

The startup behavior of JMARS can be modified by including additional command line arguments. (Note: Only one command line argument can be used at a time.)

  1. Specify the Starting Position
By default, JMARS starts with the Viewing Window centered at 0E, 0N. This staring location can be changed by addition latitude and longitude arguments to the jmars command:
>jmars "Longitude" "Latitude"
  • "Longitude" - The value is assumed to be East Longitude unless a "W" is used after the numerical value. (ie. 120W)
  • "Latitude" - The value is assumed to be North Latitude unless a "S" is used after the numerical value. (ie. 120S)

  1. Starting with Session Files
Session files allow users to restart JMARS in a previously saved configuration by specifying a startup file:
>jmars "path/session_file_name.jmars"


Starting JMARS with Flags

The startup behavior of JMARS can also be modified by including any of the following command line flags. Unlike the command line arguments above, multiple command line flags can be used at a time and they can be used in conjunction with command line arguments.

  1. Clean
The "clean" flag will clear out the map tile cache before startup.
>jmars clean

  1. Generate
The "generate" flag will create cached map data for CD distribution.
>jmars generate

  1. Slideshow
The "slideshow" flag will enable the JMARS slideshow mode.
>jmars slideshow
See the Slideshow Mode wiki page for more information.

  1. Version
The "version" flag will list some information about the JMARS version being used. The "Version" flag will list much more detailed information about the JMARS version being used.
>jmars version

>jmars Version

  1. Help
The "-help" flag will list the available command line arguments and flags in the terminal window.
>jmars -help