References

JMap Pro Startup Parameters

The JMap Pro application takes certain parameters when it is started up. These parameters specify the address of the JMap Server, the communication ports, the project to open, and many other options.

Parameters are passed to the application in various ways, depending on its starting mode. Java and JavaWebStart applet parameters are passed in the application’s JNLP file. Application parameters are passed to the command line or can be specified in an Ant script.

The following example shows the parameters passed to the command line to start a JMap Pro application that opens the project The World and loads the extension Showcase.

-appclassname jmap.viewers.docking.AppDocking -server jmap3.k2geospatial.com -directport 7003

-project "The world" -extensions jmap.examples.showcase.extension.ShowCaseClientExtension

The following table describes the various parameters:

Parameters (* = mandatory)
-appclassname *	Main class of the application to run. Currently, the only possible value is jmap.viewers.docking.AppDocking.
-server *	The name or IP address of the JMap server to which the application must connect.
-directport	IP communication port for direct connections with JMap Server.
-httpport	IP communication port for connections through HTTP proxy with JMap Server.
-project	The project that will open by default. Must be enclosed in quotes if the name contains spaces.
-language	Language of the application’s GUIs. Supported values are fr, en, es, pt, and default. The default value means that the language used will be the default language of the user’s operating system.
-country	The country, used with the language, to determine the display formats of dates and numbers.
-username	The username to log on to the application.
-password	The password to log on to the application.
-sessionid	Specifies the session number in order to connect to a session that is already open on the JMap server.
-autozoom	Instructs the JMap application to locate a position or element automatically upon startup. The syntax is: autozoom-REGION, x, y, width, height OR autozoom-OBJECT; <br />LayerName; <br />attribute, value OR autozoom-OBJECT; <br />LayerName; <br />attribute, value; <br />maxScale
-connection	Type of connection to use between the application and the JMap Server. Possible values are: - direct: Opens a direct connection to JMap Server using the direct port. - proxy: Opens a proxy HTTP connection to JMap Server using the HTTP port. - any: Attempts to open a direct connection. In case of failure, switches to connection through HTTP proxy.
-proxypath	If the connection type is HTTP-proxy, specifies a relative path to the HTTP proxy.
-serverid	If the connection type is HTTP-proxy, specifies on which JMap Server instance the connection must open when multiple instances of JMapServer are available. This way, the HTTP proxy can be used to direct the queries. Server IDs are configured in the jmsconnections.xml files.
-showconnectionmoredetails	Determines whether the login window should show the list of available projects on JMap Server. Possible values: true, false
-usediskcache	Determines whether the disk cache is enabled or not. Possible values: true, false
-diskcachepath	If the disk cache is enabled, determines the folder where the cached data will be saved.
-diskcachesize	If the disk cache is enabled, determines the maximum size of the total data cache. Data will automatically be deleted when the cache reaches the size limit. The value is expressed in bytes. A value of -1 indicates an unlimited size.
-usememorycache	Determines whether the memory cache is enabled or not. If the cache is enabled, the data in memory is handled in the following way: when the space becomes full, i.e. the cache reaches the size limit (-maxmemory parameter), data is automatically removed from the memory. The amount of data removed depends on the specified percentage (percentreleasememory parameter). Possible values: true, false
-maxmemory	If the in-memory cache is enabled, determines the maximum size of the data in memory.The value is expressed in bytes. The default value is 33554432 (32MB).
-percentreleasememory	Determines the percentage of memory to free when the cache becomes full. The percentage is based on the total size of the cache. The value is an integer between 1 and 100.
-logos	List of logos to show on the map as well as their position and transparency. Example -logos “? Jmaplogo.gif x = 5 & y = 5 & transparency = 30.0 & relativeTo = NE”
-northarrow	Display settings for a north arrow on the map, including the model, position, size, etc. Example -northarrow Simple3D, 0,50,5,5
-displayscalebar	Determines whether the scale bar must be displayed on the map. Possible values: true, false
-extensions	The list of extensions to initialize at application startup, separated by commas. Example -extensions jmap.extensions.googlemap.client.GoogleMapsExtension, jmap.examples.showcase.extension.ShowCaseClientExtension