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.


We must add an initial context for each JNDI namespace that we 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. We 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. We must know the following connection details:

    • Click Other if the JNDI namespace is located somewhere else. We 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 we 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 we 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, we can now create connection factory objects, destination objects, and subcontexts in the initial context.

Parent topic: Create and configure JMS administered objects


Related concepts


Related tasks