Category: IBM Websphere tutorials

The WebSphere MQ JMS provider maps to the WebSphere MQ messaging system which is one of the most widely used message-oriented-middleware (MOM) product in the industry. It has been available for many years and is widely used to integrate applications on disparate platforms. The key runtime artifact in WebSphere MQ is called a Queue Manager.

Since WebSphere MQ is not part of WebSphere Application Server, its Queue Managers run in separate processes and are separately administered through the WebSphere MQ Queue Manager.

In order to proceed with Websphere MQ configuration, you need to download a trial of it at: http://www-947.ibm.com/support/entry/portal/downloads/software/websphere/websphere_mq\

In order to connect to WebSphere MQ messaging provider we will show at first how to create some basic MQ objects. The following commands can be executed from the MQ_HOME/bin folder.

To create a new Queue Manager called MQQueueManager issue the following command:

crtmqm MQQueueManager

Now start the Queue Manager named MQQueueManager by typing the following command:

strmqm MQQueueManager

To stop the Queue Manager enter the following command:

endmqm MQQueueManager

In order to create a new Queue definition for the MQQueueManager, you need to use the runmqsc command which takes its input from stdin, thus you will enter your command interactively.

So, in order to create a Queue definition using MQ scripting, enter the following commands:

runmqsc MQQueueManager  define qlocal(SampleMQ)  end

Now create a listener for your Queue by entering the following commands:

runmqsc MQQueueManager  DEFINE LISTENER(MQQueueManager.listener) TRPTYPE (TCP) PORT(1424)  START LISTENER(MQQueueManager.listener)  end

Finally, restart the QueueManager for your commands to take effect:

endmqm MQQueueManager  strmqm MQQueueManager

To configure a JMS connection factory for the WebSphere MQ provider, choose Resources> JMS> Connection factories. In the Connection factories window, select the Scope of your resource and then click “New”.

In the next step select the WebSphere MQ messaging provider option,

Click OK. This will take you to the Step 1 wizard where you need to enter the Name for the Connection Factory and the JNDI name that binds it to the name space.

Click Next to continue. In the Step 2, you should determine how to connect to Websphere MQ. Choose “Enter all the required information into this wizard “option, as shown:

Click Next to continue. In the Step 2.1 you need to supply the Queue Manager or Queue sharing group name you wish to connect to. (see the paragraph “Create Websphere MQ basic objects” )

Click Next. In the Step 2.2 choose the transport type and specify the host and port of the MQ Queue Manager. The port must match the listener port that you defined for the Queue Manager.

Click Next. You can check your connection by clicking on the Test connection to verify that you can connect to the WebSphere MQ Queue Manager. In the Summary window, review your configuration, then click Finish and Save.

This excerpt from the Enter­prise Appli­ca­tion Server Cook­Book that will teach how to configure the default JMS broker for Websphere application server.

If you want to fully understand the complex topics contained in this chapter we need to make sure that you have a basic knowledge of JMS core elements:

• A Connection Factory is an object that a JMS client (a Java program that uses the JMS API) uses to create a connection with a JMS provider.
• A JMS queue is a staging area that contains messages that have been sent and are waiting to be read (by only one consumer). Note that, in contrast to what the name “queue” suggests, messages don’t need to be delivered in the order sent. A JMS queue only warranties that each message is processed only once.
• A JMS topic is a distribution mechanism for publishing messages that are delivered to multiple subscribers.

When using the default JMS provider your JMS Connection Factories will connect to a Service Integration Bus (SiBus), which hides the actual JMS implementation from the application. Applications then use queues within the SiBus to send and receive messages. At the same time, the JMS Topics are persisted in the SiBus and accessed through appropriate Connection Factories, which applications use to gain access to the Bus.

In order to create a JMS Connection Factory using the Default Provider you need at first create a Service Integration Bus which will act as a proxy between your messaging engines.

Connect to the Admin Console and choose Service Integration > Buses. Click on “New”. The new Bus wizard will start. In Step 1 enter the name of your Bus:

If you have checked the Bus security option you will ensure that client applications authenticate to the bus and the authorization policy for the Bus is enforced. This will add some additional screen shots for specifying which security domain to use for securing your Bus. Please refer to the Chapter 11 for learning how to create a security domain).

Click on Next. In Step 2 you will be requested to confirm the creation of your Bus. Once confirmed, the Bus will be enlisted in the Bus summary page as shown by the following picture:

To complete the configuration of the SiBus, we must add an existing server as a member to the SiBus so that we have a facility for message persistence.

In order to do that, click on the “JMSBus” just created and, within the Topology section, click Bus members, as shown by the following screenshot:

You will now be presented with a screen where you can add Bus members.

By clicking Add and you will be able to select the server you wish to add as a member to the Bus. You will notice that the Server option is already pre-selected, as shown in the following screenshot:

Click Next to proceed to the final screen, where you will choose the message persistence option between File store and Data store (the first one will persist your messages on a file system, the second one obviously on a database):

The next screen will be dependent on your message store. Supposing that you have selected “File Store”, in the next step you will be able to configure the File Store properties:

Click Next. In the following screen you will be able to tune performance parameters by choosing an appropriate JVM heap size; in the following screen we have just left the default values:

Clicking Next again will take you to the Summary page where you can review your configuration. Click Finish and Save to retain the changes.

You will now see the application server called server01 listed as a Bus member. At this point, the server must be restarted in order to activate the SiBus message engine. In the next recipes we can start configuring JMS resources on the top of it.