Introduction
Collaboration enables individuals to access information, expertise, and resources regardless of time or geography. Lotus Domino provides you with the means to realize this collaboration.
The WebSphere MQ products enable programs to communicate with one another across a network of dissimilar components -- processors, operating systems, subsystems, and communication protocols -- using a consistent application programming interface.
This tutorial discusses how you can integrate Lotus Domino with WebSphere MQ using LotusScript and the Java platform. We'll set up two forms in Lotus Domino for use by a Lotus Notes client -- one to put a message to, and the other to get a message from, WebSphere MQ. Then we'll set up two more forms for the Web to do the same thing. We could have created just two forms -- one for the Notes client and the other for the browser client -- but by proceeding in this way, we'll see two different ways to use the Java platform within Domino. Finally, we'll set up a Domino Java scheduled agent that will execute every hour to see if there are any messages on a particular queue.
Companies today have business software on disparate systems. For example, the human resources system might be on a Sun Solaris server, a customer relationship management system might be on Microsoft Windows, and financials might be on a mainframe. Companies have a need to connect these systems, and developing the middleware to connect these systems is expensive. WebSphere MQ can connect all your business software to form one efficient enterprise. WebSphere MQ minimizes time taken to integrate applications on different systems, so your company can respond quickly to new market strategies. While the examples we're using here may seem simple, many of WebSphere MQ's integration functions are based on two actions: putting messages on queues and reading them off of queues. Once you've learned a few simple ways to achieve these tasks with Domino, a wide vista of integration options is open to you.
Who should take this tutorial?
This tutorial will be useful for developers who are working in an environment where Lotus Domino and WebSphere MQ are deployed, and who would like to know how to integrate these two products.
Also, this tutorial will be useful for developers who are using the LotusScript extension for MQSeries (MQLSX) today. MQLSX is not supported in the Lotus Domino 6 environment, and since support for MQLSX will end on December 31, 2004, it is recommended that any new solutions be written in the Java language within the Domino 6 environment.
After completing this tutorial, you should know how to integrate Lotus Domino and WebSphere MQ using LotusScript and the Java language.
For the purposes of this tutorial, we'll be using Lotus Domino 6 and WebSphere MQ 5.3, which, at the time of writing, are the most current releases of those products. For more information on the system requirements for running these applications, see the documentation that accompanies them.
This tutorial guides you through the use of a Lotus Domino database that uses the WebSphere MQ Java set of classes to put and get messages. You'll need a Lotus Domino version 6 server, Domino Designer version 6, and a Lotus Notes version 6 client. The Domino database will put a message and get the message from a WebSphere MQ queue. You'll also need a WebSphere MQ version 5.3 server installed. If the WebSphere MQ server is not installed on the same machine as the Lotus Domino server, you need to install the WebSphere MQ client on the same machine as the Lotus Domino server.
You can download trial versions of the required Lotus software at no charge. All of this software is accompanied by installation instructions.
WebSphere MQ has available downloadable packages of code and documentation, called SupportPacs, which complement the entire family of WebSphere MQ products. The majority of SupportPacs are available at no charge. Others can be purchased as fee-based services from IBM.
To test your WebSphere MQ installation, refer to the WebSphere MQ installation verification section of this tutorial.


