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
Variable
|
Description
|
IMQ_HOME
|
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.
|
IMQ_VARHOME
|
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.
|
IMQ_JAVAHOME
|
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 (/).