Configuring JMS resources using the administrative console

You can use the WebSphere® Application Server administrative console to configure activation specifications, connection factories and destinations for the IBM® MQ JMS provider.

About this task

You can use the WebSphere Application Server administrative console to create, view, or modify any of the following resources:
  • Activation specifications
  • Domain-independent connection factories (JMS 1.1 or later)
  • Queue connection factories
  • Topic connection factories
  • Queues
  • Topics
The following steps provide an overview of the ways in which you can use the administrative console to configure JMS resources for use with the IBM MQ messaging provider. Each step includes the name of the topic in the WebSphere Application Server product documentation to which you can refer for more information. See Related links for links to these topics in the WebSphere Application Server product documentation.

In a mixed-version WebSphere Application Server cell, you can administer IBM MQ resources on nodes of all versions. However, some properties are not available on all versions. In this situation, only the properties of that particular node are displayed in the administrative console.

Procedure

To create or configure an activation specification for use with the IBM MQ messaging provider:

  • To create an activation specification, use the Create IBM MQ JMS resource wizard.
    You can either use the wizard to specify all the details for the activation specification, or you can choose to specify the connection details for the IBM MQ by using a client channel definition table (CCDT). When you specify the connection details using the wizard, you can choose either to enter host and port information separately or, if you are using a multi-instance queue manager, to enter host and port information in the form of a connection name list. For more information, see Creating an activation specification for the IBM MQ messaging provider.
  • To view or change the configuration properties of an activation specification, use the administrative console IBM MQ messaging provider connection factory settings panel.
    These configuration properties control how connections are created to associated queues and topics. For more information, see Configuring an activation specification for the IBM MQ messaging provider.

To create or configure a unified connection factory, a queue connection factory, or a topic connection factory for use with the IBM MQ messaging provider:

  • To create a connection factory, first select the type of connection factory that you want to create, then use the Create IBM MQ JMS resource wizard to specify the details.
    • If your JMS application is intended to use only point-to-point messaging, create a domain-specific connection factory for the point-to-point messaging domain that can be used for creating connections specifically for point-to-point messaging.
    • If your JMS application is intended only to use publish/subscribe messaging, create a domain-specific connection factory for the publish/subscribe messaging domain that can be used for creating connections specifically for publish/subscribe messaging.
    • For JMS 1.1 or later, create a domain-independent connection factory that can be used for both point-to-point messaging and publish/subscribe messaging, allowing your application to perform both point-to-point and publish/subscribe work under the same transaction.
    You can choose whether to use the wizard to specify all the details for the connection factory, or you can choose to specify the connection details for the IBM MQ by using a client channel definition table (CCDT). When you specify the connection details using the wizard, you can choose either to enter host and port information separately or, if you are using a multi-instance queue manager, to enter host and port information in the form of a connection name list. For more information, see Creating a connection factory for the IBM MQ messaging provider.

To view or change the configuration properties of a connection factory:

  • Use the administrative console connection factory settings panel for the type of connection factory that you want to configure.
    The configuration properties control how connections are created to associated queues and topics. For more information, see Configuring a collection factory for the IBM MQ messaging provider, or Configuring a queue collection factory for the IBM MQ messaging provider, or Configuring a topic collection factory for the IBM MQ messaging provider.

To configure a JMS queue destination for point-to-point messaging with the IBM MQ messaging provider:

  • Use the administrative console IBM MQ messaging provider queue settings panel to define the following types of property:
    • General properties, including administration and IBM MQ queue properties.
    • Connection properties that specify how to connect to the queue manager that hosts the queue.
    • Advanced properties that control the behavior of connections made to IBM MQ messaging provider destinations.
    • Any custom properties for the queue destination.
    For more information, see Configuring a queue for the IBM MQ messaging provider.

To create or configure a JMS topic destination for publish/subscribe messaging with the IBM MQ messaging provider:

  • Use the IBM MQ messaging provider topic settings panel to define the following types of property:
    • General properties, including administration and IBM MQ topic properties.
    • Advanced properties that control the behavior of connections made to IBM MQ messaging provider destinations.
    • Any custom properties for the queue destination.
    For more information, see Configuring a topic for the IBM MQ messaging provider.