Add an initial context

To create and configure JMS objects in MQ Explorer, you must add an initial context to define the root of the JNDI namespace in which the JMS objects are stored in the naming and directory service.

You must add an initial context for each JNDI namespace to access. All of the initial contexts that you add to MQ Explorer are displayed in the JMS Administered Objects folder in the Navigator view.

To add an initial context to the JMS Administered Objects folder in MQ Explorer, complete the following steps.

Procedure

1. In the Navigator view, right-click the JMS Administered Objects folder, then click Add Initial Context The Add Initial Context wizard opens.
2. Select the location of the JNDI namespace in the naming and directory service:
   • Click LDAP server if the JNDI namespace is located on an LDAP server. You must know the following connection details:
     • The host name of the LDAP server.
     • The distinguished name of the location of the JNDI namespace.
   • Click File system if the JNDI namespace is located in a file system. You must know the following connection details:
     • The path to the location of the JNDI namespace in the file system.
   • Click Other if the JNDI namespace is located somewhere else. You must know the following connection details:
     • The name and location of the initial context factory class of the JNDI service provider.
     • The URL of the location of the JNDI namespace.
3. If the JNDI namespace is on an LDAP server, or is provided by some other JNDI service provider that requires authentication, select the type of authentication that MQ Explorer must use to connect to the JNDI namespace:
   • Click None to use anonymous authentication to connect to the JNDI namespace. The JNDI does not pass any security credentials to the service provider from MQ Explorer.
   • Click Simple authentication if MQ Explorer must pass security credentials to the JNDI service provider.
   • Click CRAM-MD5 authentication if MQ Explorer must pass security credentials of CRAM-MD5 standard to the JNDI service provider.
4. Optional: Edit the nickname that will be used to display the initial context in MQ Explorer. By default, the location of the JNDI namespace is used but we can change it to something that is easier to read and recognize.
5. Optional: Select whether MQ Explorer automatically connects to the initial context:
   • Select the Connect immediately on finish check box to connect to the initial context when the wizard closes.

     If you clear this check box, when the wizard closes, the initial context is added to the JMS Administered Objects folder but MQ Explorer cannot access the JMS objects in the JNDI namespace until you connect to the initial context.

   • Select the Automatically reconnect to context on startup check box if you want MQ Explorer to automatically reconnect to the initial context every time that you close and re-open MQ Explorer.
6. Click Finish.

Results

The initial context is added to the JMS Administered Objects folder in the Navigator view. If MQ Explorer is connected to the initial context, we can now create connection factory objects, destination objects, and subcontexts in the initial context.