Sun Java System Message Queue 4.1 Developer's Guide for JMX Clients

Directory Variable Conventions

Message Queue makes use of three directory variables; how they are set varies from platform to platform. Table P–6 describes these variables and how they are used on the Solaris, Linux, and Windows platforms.

Note –

The information in Table P–6 applies only to the standalone installation of Message Queue. When Message Queue is installed and run as part of an Application Server installation, the values of the directory variables are set differently: IMQ_HOME is set to appServer_install_dir/imq (where appServer_install_dir is the Application Server installation directory), and IMQ_VARHOME is set to appServer_domainName_dir/imq (where appServer_domainName_dir is the domain directory for the domain starting the Message Queue broker).

Table P–6 Directory Variable Conventions




The Message Queue base directory (root installation directory):  

  • Unused on Solaris and Linux; there is no Message Queue base directory.

  • On Windows, set by the Message Queue Installer to the directory in which you unzip the Message Queue bundle.


The directory in which Message Queue temporary or dynamically created configuration and data files are stored; can be set as an environment variable to point to any directory.  

  • On Solaris, defaults to /var/imq.

  • On Linux, defaults to /var/opt/sun/mq.

  • On Windows, defaults to IMQ_HOME\var.


The location of the Java runtime environment (JRE) required by Message Queue executables:

  • On Solaris and Linux, set by default to the location of the latest JRE, but can optionally be set to point to another, preferred JRE instead.

  • On Windows, set to the location of an existing JRE if a supported version is found on the system. If a supported version is not found, one will be installed.

Note –

In this manual, these directory variables are shown without platform-specific environment variable notation or syntax (such as $IMQ_HOME on UNIX). Pathnames generally use UNIX directory separator notation (/).