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
- In the Navigator view, right-click the JMS Administered
Objects folder, then click Add Initial Context The Add Initial Context wizard opens.
- 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.
- 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.
- 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.
- 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.
- 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.