Configuring the JMS administration tool
The IBM® MQ JMS administration tool uses a configuration file to set the values of certain properties. A sample configuration file is supplied, which you can edit to suit your system.
About this task
#Set the service provider
INITIAL_CONTEXT_FACTORY=com.sun.jndi.ldap.LdapCtxFactory
#Set the initial context
PROVIDER_URL=ldap://polaris/o=ibm_us,c=us
#Set the authentication type
SECURITY_AUTHENTICATION=none
(In this example, a hash sign (#) in the first column
of the line indicates a comment, or a line that is not used.)
A sample configuration file, which is used as the default configuration file, is supplied with IBM MQ. The sample file is called JMSAdmin.config
, and is found in the <MQ_JAVA_INSTALL_PATH>/bin
directory. You can either edit this sample file to define the settings needed for your system, or create your own configuration file.
When you start the administration tool, you can specify the configuration file that you want to use by using the -cfg
command-line parameter, as described in Starting the administration tool. If you do not specify a configuration file name when you invoke the tool, the tool attempts to load the default configuration file ( JMSAdmin.config
). It searches for this file first in the current directory, and then in the <MQ_JAVA_INSTALL_PATH>/bin
directory, where <MQ_JAVA_INSTALL_PATH>
is the path to your IBM MQ classes for JMS installation.
The names of JMS objects that are stored in an LDAP environment must comply with LDAP naming conventions. One of these conventions is that object and context names must include a prefix, such as cn=
(common name), or ou=
(organizational unit). The administration tool simplifies the use of LDAP service providers by allowing you to refer to object and context names without a prefix. If you do not supply a prefix, the tool automatically adds a default prefix to the name you supply. For LDAP, this is cn=
. If required, you can change the default prefix by setting the NAME_PREFIX property in the configuration file.