This topic describes how to install IBM WebSphereMQ on your computer and create a simple configuration.
Download the IBM WebSphereMQ installer from the IBM website and run it:
Follow the instructions of the installation wizard.
After the installation is complete, open the WebSphere MQ Explorer. The following steps show how you can use this application to create a basic configuration.
Before creating a queue, you need to create a queue manager. Queue managers handle application connections to queues listed in the manager and manage the queues. They ensure that the commands are executed properly, events happen and messages are added to the appropriate queues. To create a queue manager:
Right-click Queue Managers in the navigator panel and select New > Queue Manager
Specify a name for the queue manager.
|This name will be used later when configuring destinations.|
Click Next > Next > Next and specify a port number in the Listen on port number field. You can leave the default port number and go to the next step.
Click Finish to create the queue manager.
To simplify the connection process, disable authentication for the queue manager:
|This step is not obligatory. You can still connect to the WebSphereMQ server that requires authentication.|
Right-click the created queue manager and select Properties.
In the subsequent dialog, switch to the Communications tab and set the Channel authentication records option to Disabled.
Close the dialog.
Make sure there are no items in the QueueManagerName > Channels > Channel Authentication Records panel.
Queues in Websphere MQ are message containers. When an application is connected to a queue manager, it can retrieve messages from a queue or add them to a queue. To create a queue:
Right-click the QueueManagerName > Queues item in the navigator panel and select New > Local Queue.
In the subsequent dialog, specify the queue Name.
Click Finish to create the queue with the default parameters, or click Next to configure advanced queue properties.
An initial context provides applications that connect to WebSphere MQ with a context they can use to interact with it and a starting point for name resolution. Without it, an application will be unable to connect to a queue. HermesJMS can handle connections to the server without using an initial context, but ReadyAPI needs it to create a direct connection.
To add an initial context:
Right-click JMS Administered Objects and select Add Initial Context.
In the subsequent dialog, select the File System option.
In the Binding directory field, specify the path to an empty folder.
A connection factory is a Java object that a client uses to create a connection to the JMS provider. To create it in WebSphere MQ:
Right-click Initial Context > Connection Factories and select New > Connection Factory.
In the subsequent dialog, specify a name for the connection factory.
In the Messaging provider drop-down list, select WebSphere MQ.
Click Next > Next.
In the Transport drop-down list, select MQ Client.
Follow the instructions of the wizard.
Destinations add queues to an initial context so that an application that connects to WebSphere MQ and gets a context can find them.
Right-click Initial Context > Destinations and select New > Destination.
In the subsequent dialog, specify the destination name.
Click Next > Next.
In the Queue manager field, specify the name of the queue manager you created earlier.
In the Queue field, specify the name of the queue you created earlier.
Close the dialog. If necessary, create destinations for other queues you created.
You have configured the WebSphere MQ service. It is now ready to receive requests from applications and handle them. To continue working with it from ReadyAPI: