jMax jMax documentation

Running jMax


Running jMax

jMax can be run by executing the jmax shell script. This script is located in the following directories:

This script accepts a set of options (see jmax -help for description) that are either interpreted by the script or passed as command line arguments to the Java application.

The -root option of the jmax script specifies the root directory, i.e. where the jMax resources (Java classes, server binaries, configuration files, standard packages, ...) are located. jMax default root directory is /usr/lib/jmax and the installation process (either 'make install' or platform-specific installer) places resources there. If running from a source distribution, the -root option must be used to specify in which directory the resources are located, as in:

jmax -root /home/francois/jmax


Command Line Arguments

jMax uses a number of configuration parameters to parametrize the system at startup.These parameters appear as TCL variables and can be also set via the command line:

The parameter values given in the command line overwrite all default values given in the user or site specific configuration files (see down).

The chapter configuration of this documentation explain the different jMax configuration parameters. At least one of the host parameters should be set properly in order to start jMax in a default setup.

The user can implicitly define his own options in the command line using the same syntax like for the configuration parameters. For example, the command

sets the jMax server host name to jack and the user option named myOption to the value pho while starting up jMax. The value of this user option can be accessed through the TCL command systemProperty For example in the following construct:

Copyright © 1995,1999 IRCAM.
All rights reserved.