Configuration

 

Configure the administration tool with values for the following properties:

INITIAL_CONTEXT_FACTORY

The service provider that the tool uses. The supported values for this property are as follows:

  • com.sun.jndi.ldap.LdapCtxFactory (for LDAP)

  • com.sun.jndi.fscontext.RefFSContextFactory (for file system context)

On z/OS, com.ibm.jndi.LDAPCtxFactory is also supported and provides access to an LDAP server. However, this is incompatible with com.sun.jndi.ldap.LdapCtxFactory, in that objects created using one InitialContextFactory cannot be read or modified using the other.

We can also use an InitialContextFactory that is not in the list above. See Using an unlisted InitialContextFactory for more details.

PROVIDER_URL

The URL of the session's initial context; the root of all JNDI operations carried out by the tool. Two forms of this property are supported:

  • ldap://hostname/contextname

  • file:[drive:]/pathname

SECURITY_AUTHENTICATION

Whether JNDI passes security credentials to your service provider. This property is used only when an LDAP service provider is used. This property can take one of three values:

  • none (anonymous authentication)

  • simple (simple authentication)

  • CRAM-MD5 (CRAM-MD5 authentication mechanism)

If a valid value is not supplied, the property defaults to none. See Security for more details about security with the administration tool.

These properties are set in a configuration file. When you invoke the tool, we can specify this configuration by using the -cfg command-line parameter, as described in Invoking the administration tool. If you do not specify a configuration file name, the tool attempts to load the default configuration file (JMSAdmin.config). It looks 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 WebSphere MQ JMS installation.

The configuration file is a plain-text file that consists of a set of key-value pairs, separated by =. This is shown in the following example: 

#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

(A # in the first column of the line indicates a comment, or a line that is not used.)

The installation comes with a sample configuration file that is called JMSAdmin.config, and is found in the <MQ_JAVA_INSTALL_PATH>/bin directory. Edit this file to suit the setup of your system.


uj10810_