Customising an MS Windows Installation

This section applies if you installed Jim on a Microsoft Windows system. It describes how to tailor the installation if the programme will not start, if you wish to improve the performance of Jim, change the classpath so you can load plugins, or if you want to run Jim's stand-alone tools in batch (text-only) mode.

In the installation directory are executables (.exe files) that are used to start Jim and the stand-alone Tools from the start menu. In a sub-directory called JExpress, there are properties files that are used when Jim and the tools are run. For example, for Jim, there is a file called Jim.properties, which will have contents similar to that shown below:

#Menu for Jim
#Wed Mar 12 17:45:28 GMT 2008
programName=Jim
args=-Dlicense.filename\=license.txt -Xms32m -Xmx1024m -cp .;j3d-vrml97.jar;xinapse6.jar;itext.jar;mstemplate.jar;cli.jar com.xinapse.apps.jim.Jim
startDir=C\:\\Program Files\\Xinapse\\Jim6
execFilename=C\:\\PROGRA~1\\Java\\JRE16~2.0_0\\bin\\javaw.exe

1. If you receive messages from Jim that it does not have enough memory to load images, or if it hogs memory. The setting -Xmx1024m allows Jim to use a maximum of 1024 MB of memory, regardless of how much RAM your computer has. You can increase this number if you find that Jim runs out of memory. For example, to allow Jim to use a maximum of 1536 MB of memory, change it to -Xmx1536m

   The setting -Xms32m set the amount of memory consumed by Jim immediately on startup, and should not need to be changed.

   Note: on 32-bit Microsoft Windows systems, the maximum memory that can be set is 1536MB. This is because of a limitation in the way that Windows partitions memory.

   Note: even on 64-bit Microsoft Windows systems, you may not be able to exceed 1536MB of memory unless you set an additional flag "-d64" (without the quotes, but with a space on either side) after the -Xmx...m flag.

2. If Jim cannot find the license file, you can tell it explicitly where to look. Change the setting of -Dlicense.filename\=license.txt to give the exact path to the license file. For example:
   -Dlicense.filename\=C\:\\license.txt
   if you put your license file in the root directory of the C drive.

   N.B. you must 'escape' special characters such as = : and \ with an extra backslash character.

3. If you want to use plugins for the DCE-MRI tool, or Dynamic Analysis tool, you may need to alter Jim's classpath so that Jim can find the plugin(s). You can either:
   1. Put all your plugins into one of two standard locations, in which case Jim will find the plugins automatically. The standard location are:
      • The sub-folder plugins in the Jim install folder.
      • The sub-folder JimPlugins in your home folder.
   2. Tell Jim where the plugins can be found, by altering the classpath above.

      After the section which says:

      -cp .;j3d-vrml97.jar;xinapse6.jar;itext.jar;mstemplate.jar;cli.jar

      append the full path to your plugin folder(s):

      -cp .;j3d-vrml97.jar;xinapse6.jar;itext.jar;mstemplate.jar;cli.jar;Path_To_You_Plugin_Folder

      where Path_To_You_Plugin_Folder is the full path to the folder containing your plugins.

You can customise the amount of memory used by each of Jim's stand-alone tools in exactly the same way above, to tailor the amount of memory used, etc. Do this by editing the appropriate .properties file for the tool.

Running the Stand-Alone Tools from Batch Files

WWW Xinapse Web Site