Adding an initial context

To create and configure JMS objects in IBM® 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.

About this task

You must add an initial context for each JNDI namespace that you want to access. All of the initial contexts that you add to IBM 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 IBM 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 IBM 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 IBM MQ Explorer.
    • Click Simple authentication if IBM MQ Explorer must pass security credentials to the JNDI service provider.
    • Click CRAM-MD5 authentication if IBM 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 IBM MQ Explorer. By default, the location of the JNDI namespace is used but you can change it to something that is easier to read and recognize.
  5. Optional: Select whether IBM 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 IBM 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 IBM MQ Explorer to automatically reconnect to the initial context every time that you close and re-open IBM MQ Explorer.
  6. Click Finish.

Results

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