docs.intersystems.com
Home  /  Application Development: Using Adapters and Gateways in Productions  /  Using IBM WebSphere MQ Adapters in Productions  /  About the IBM WebSphere MQ Adapters


Using IBM WebSphere MQ Adapters in Productions
About the IBM WebSphere MQ Adapters
[Back]  [Next] 
InterSystems: The power behind what matters   
Search:  


The InterSystems IRIS™ IBM WebSphere MQ inbound and outbound adapters enable your productions to retrieve messages from and send messages to message queues of InterSystems IRIS IBM WebSphere MQ. This chapter provides a brief introduction to these adapters.
It is assumed that you are reasonably familiar with the IBM WebSphere MQ product and have access to its formal documentation.
Prerequisites
In order to use InterSystems IRIS IBM WebSphere MQ inbound and outbound adapters, make sure that you have access to IBM WebSphere MQ as described in the chapter “Sending and Receiving IBM WebSphere MQ Messages” in Using Internet Utilities.
The adapters use a dynamic-link library that is automatically installed by InterSystems IRIS on all suitable platforms. (This is MQInterface.dll on Windows; the file extension is different for other platforms.) In turn, the InterSystems IRIS dynamic-link library requires IBM WebSphere MQ dynamic-link libraries (the IBM WebSphere MQ client).
The IBM WebSphere MQ Inbound Adapter
In general, the inbound IBM WebSphere MQ adapter (EnsLib.MQSeries.InboundAdapter) accesses a given queue manager, using a given channel, retrieves messages from a given queue, and sends those messages (as instances of EnsLib.MQSeries.Message) to the associated business service.
The adapter provides runtime settings that you use to specify items like the following:
Note:
Each retrieved message must be less than 32 KB in length unless long strings are enabled in InterSystems IRIS.
The IBM WebSphere MQ Outbound Adapter
The IBM WebSphere MQ outbound adapter (EnsLib.MQSeries.OutboundAdapter) provides settings that you use to specify the following:
It provides a method to send a message to the given queue.
Note:
The message must be less than 32 KB in length unless long strings are enabled in InterSystems IRIS.
The MQ Adapters and the Event Log
Unlike many other production adapters, the IBM WebSphere MQ inbound and outbound adapters do not write to the Event Log when they process messages sent to or received from outside InterSystems IRIS. To see the inbound and outbound traffic, you can, however, use the message browser as usual.