Configure JMS resources

One of the ways in which a JMS application can create and configure the resources that it needs to connect to IBM MQ and access destinations for sending or receiving messages is by using the Java Naming and Directory Interface (JNDI) to retrieve administered objects from a location within the naming and directory service that is called the JNDI namespace. Before a JMS application can retrieve administered objects from a JNDI namespace, you must first create and configure the administered objects.


We can create and configure administered objects in IBM MQ by using either of the following tools:

    IBM MQ Explorer
    We can use IBM MQ Explorer to create and administer JMS object definitions that are stored in LDAP, in a local file system, or other locations.

    IBM MQ JMS administration tool
    The IBM MQ JMS administration tool is a command-line tool that we can use to create and configure IBM MQ JMS objects that are stored in LDAP, in a local file system, or other locations. The JMS administration tool uses a syntax that is similar to runmqsc, and also supports scripting.

    The administration tool uses a configuration file to set the values of certain properties. A sample configuration file is supplied, which we can edit to suit your system before you start by using the tool to configure JMS resources. For more information about the configuration file, see Configure the JMS administration tool.

IBM MQ JMS applications that are deployed to WebSphere Application Server need to access JMS objects from the application server JNDI repository. Therefore, if we use JMS messaging between WebSphere Application Server and IBM MQ, you must create objects in WebSphere Application Server that correspond to the objects that you create in IBM MQ.

IBM MQ Explorer and the IBM MQ JMS administration tool cannot be used to administer IBM MQ JMS objects that are stored in WebSphere Application Server. Instead, we can create and configure administered objects in WebSphere Application Server by using either of the following tools:

    WebSphere Application Server administrative console
    The WebSphere Application Server administrative console is a web-based tool that we can use to manage IBM MQ JMS objects in WebSphere Application Server.

    WebSphere Application Server wsadmin scripting client
    The WebSphere Application Server wsadmin scripting client provides specialized commands to administer IBM MQ JMS objects in WebSphere Application Server.

If you want to use a JMS application to access the resources of an IBM MQ queue manager from within WebSphere Application Server, you must use the IBM MQ messaging provider in WebSphere Application Server, which contains a version of the IBM MQ classes for JMS. The IBM MQ resource adapter that is supplied with WebSphere Application Server is used by all applications that carry out JMS messaging with the IBM MQ messaging provider. The IBM MQ resource adapter is usually updated automatically when you apply WebSphere Application Server fix packs, but if we have previously manually updated the resource adapter, you must manually update your configuration to ensure that maintenance is applied correctly.