webMethods WebSphere MQ Adapter

Release Notes


webMethods WebSphere MQ Adapter Version 6.5

Software AG introduces version 6.5 of the webMethods WebSphere MQ Adapter. This is a major release of the adapter that provides several features to help you manage your WebSphere MQ integrations more easily. The WebSphere MQ Adapter provides seamless and real-time communication to and from WebSphere MQ without requiring changes to the WebSphere MQ system. Now you can leverage your existing WebSphere MQ information flow to collaborate with your customers, suppliers, and other business partners via webMethods Fabric.

Enable Listeners to Listen to Multiple Queues Simultaneously

The WebSphere MQ Adapter now simplifies the management of your large scale WebSphere MQ integrations by allowing you to configure a single listener that can listen to multiple queues on a queue manager, reducing the number of adapter connections and listener notifications that must be managed in your environment. This release of the adapter introduces a new type of listener called a Multi-Queue Listener, which you configure to listen to multiple queues on a single queue manager. For each queue you define in a Multi-Queue Listener's adapter connection, the adapter will create a child listener to receive MQ messages. When you manage a Multi-Queue Listener, all of the child listeners associated with it inherit its properties. For example, any adapter notifications associated with the Multi-Queue Listener are automatically associated with all of the child listeners, greatly reducing the number of notifications you must configure.

Query Properties of Queues and Queue Managers

The adapter provides a new adapter service called the InquireQueueManager service, which enables you to inquire properties of a WebSphere MQ queue and queue manager. The output of this service provides useful information about the properties of queues, such as the current depth of the queue, as well as properties of queue managers, such as the queue manager's dead letter queue name and connection count. Because these properties are returned in the output of the adapter service, this service enables you to design Java or flow services and make logical branches based on the data returned by the service.

Enable Users to Execute PCF Commands as Adapter Services

The adapter provides a new adapter service called the PCFCommand service that enables you to issue Programmable Command Formats (PCF) commands directly from your Java and flow services. You can use this service to issue PCF commands to fetch information about Websphere MQ objects (such as queue managers, queues, and channels), and also to perform administrative functions on these objects.

Send Messages to Remote Queues from Local Queue Managers

This feature enables the Put and RequestReply adapter services to send messages to a queue that is defined on a remote queue manager even though the adapter is connected to a local queue manager, without having to define a remote queue on the local queue manager. This feature makes it possible to send data to remote "Reply To" queues and "Reply To" queue managers, and is also helpful in conserving the number of connections opened on multiple Websphere MQ servers.

Add User-Defined Fields to Message Headers

The adapter now enables you to add user-defined fields to the JMSProperties header, as well as to add user-defined headers in the Get, Peek, Put, and RequestReply services, and Listener Notifications.

Compatibility with Previous webMethods WebSphere MQ Adapters

The webMethods WebSphere MQ Adapter 6.5 is compatible with the webMethods WebSphere MQ Adapter 6.0 and 6.0 SP1. That is, you can use the webMethods WebSphere MQ Adapter 6.5 to run or edit services and listeners you generated using the WebSphere MQ Adapter 6.0 and 6.0 SP1.

For a list of all the changes and issues resolved since the last release, see the readme file for webMethods WebSphere MQ Adapter on the Software AG Documentation Web site at http://documentation.softwareag.com/ or in the directories in which you installed webMethods WebSphere MQ Adapter 6.5.

For information about previous releases of the webMethods WebSphere MQ Adapter, see the release notes for those releases, below.

Platform Support

The webMethods WebSphere MQ Adapter supports WebSphere MQ 5.1, 5.2, 5.3, and 6.0.

For a complete listing of the versions of WebSphere MQ and of webMethods Integration Server with which the adapter works, see the webMethods WebSphere MQ Adapter Installation and User’s Guide 6.5.


webMethods WebSphere MQ Adapter Version 6.0

The webMethods WebSphere MQ Adapter provides seamless and real-time communication to and from the WebSphere MQ system without requiring changes to the WebSphere MQ system. Now, companies can leverage their existing WebSphere MQ information flow to collaborate with their customers, suppliers, and other business partners via the webMethods integration platform.

For example, you can retrieve a purchase order from a WebSphere MQ server and route the purchase order to a supplier over the Internet. Additionally, you can query order status information against suppliers' extranets and deliver the information to a back-end system through the WebSphere MQ server.

Summary of Major Features

Connectivity to WebSphere MQ

The WebSphere MQ Adapter enables you to establish and manage connections to your WebSphere MQ queue managers. Connections, connection pools, and sessions are fully managed by the adapter. Through these connections you can create and run your WebSphere MQ integrations.

Dynamically Look Up WebSphere MQ Queues

When developing your integrations, you use the adapter and its webMethods Developer screens to view WebSphere MQ queues. From the list of queues, you select those on which you want to perform operations.

Template-Based Integrations

The WebSphere MQ Adapter provides service templates for interactions with the WebSphere MQ queue managers and queues. This makes it easy to develop adapter services to interact with WebSphere MQ.

Service templates represent specific WebSphere MQ operations. For example, a WebSphere MQ Adapter service that puts a message on a queue is based on the Put service template included with the adapter. You can create specific adapter services using the templates and invoke them from your integration flows.

The WebSphere MQ Adapter provides the ability to generate adapter services that implement the following WebSphere MQ operations:

Put

Opens a session to a WebSphere MQ Queue Manager and delivers a message to a specified queue.

Get

Opens a session to a WebSphere MQ Queue Manager and retrieves a message from a specified queue.

Peek

Opens a session to a WebSphere MQ Queue Manager and retrieves a copy of a message without removing the original message from a specified queue.

Request/Reply

Opens a session to a WebSphere MQ Queue Manager. This service delivers a message to a specified queue and retrieves a corresponding response from the sent message.

WebSphere MQ Adapter Notifications

The WebSphere MQ Adapter provides listeners and listener notifications to perform the following functions:

Listeners

A listener continually monitors a queue for messages. When a message appears on a queue, the listener fetches the message, based on the filter criteria that you selected when you configured the listener. The listener passes the message to the listener notification. Unlike the Put and Get adapter services, you never invoke a listener directly from a service or client. Instead, a listener is a real-time process that you configure, enable, and disable using the Administrator.

Listener Notifications

A listener notification works in conjunction with a listener to filter and process messages in the WebSphere MQ Adapter. When a listener detects a message on a queue, the listener performs a "Get" to retrieve the message, and passes the message to the listener notification. The listener notification receives the message and performs an additional filter on the message, based on the filter criteria that you selected when you configured the listener notification. The listener notification processes the message either synchronously or asynchronously.

Compatibility with Previous webMethods WebSphere MQ Adapters

The webMethods WebSphere MQ Adapter 6.0 is a new adapter and is not compatible with integrations built using the webMethods WebSphere MQ Adapter 3.0. That is, you cannot use the webMethods WebSphere MQ Adapter 6.0 to run or edit services you generated using the earlier WebSphere MQ adapters, and vice versa.

However, you can run the webMethods WebSphere MQ Adapter 6.0 on the same Integration Server with earlier webMethods WebSphere MQ adapters.


Copyright © 2012  Software AG, Darmstadt, Germany and/or Software AG USA, Inc., Reston, VA, United States of America, and/or their licensors.

Detailed information on trademarks and patents owned by Software AG and/or its subsidiaries is located at http://documentation.softwareag.com/legal/.

Use of this software is subject to adherence to Software AG’s licensing conditions and terms. These terms are part of the product documentation, located at http://documentation.softwareag.com/legal/ and/or in the root installation directory of the licensed product(s).

This software may include portions of third-party products. For third-party copyright notices and license terms, please refer to "License Texts, Copyright Notices and Disclaimers of Third Party Products." This document is part of the product documentation, located at http://documentation.softwareag.com/legal/ and/or in the root installation directory of the licensed product(s).