Adapter for WebSphere MQ environment

Before installing, configuring, and using the adapter, you must understand its environmental requirements:

Prerequisites

For information on broker compatibility, supported platforms, and more, see http://www.ibm.com/support/docview.wss?uid=swg27006249.

Adapter dependencies

The adapter has the following software prerequisites and other dependencies:

Note:
The adapter does not support Secure Sockets Layer (SSL) in WebSphere MQ 5.3. For the WebSphere MQ software version appropriate to adapter framework-integration broker communication, see the Installation Guide for your platform (Windows/Unix).

Locale-dependent data

The connector has been internationalized so that it can support double-byte character sets, and deliver message text in the specified language. When the connector transfers data from a location that uses one character code to a location that uses a different code set, it performs character conversion to preserves the meaning of the data.

This adapter supports the processing of bidirectional script data for the Arabic and Hebrew languages when the adapter is run in a Windows environment. Bidirectional processing is not supported in non-Windows environments. To use the bidirectional capacity, you must configure the bidirectional standard properties. For more information, refer to the standard configuration properties for connectors in Appendix A.

The Java runtime environment within the Java Virtual Machine (JVM) represents data in the Unicode character code set. Unicode contains encoding for characters in most known character code sets (both single-byte and multibyte). Most components in the WebSphere business integration system are written in Java. Therefore, when data is transferred between most integration components, there is no need for character conversion.

To log error and informational messages in the appropriate language and for the appropriate country or territory, configure the Locale standard configuration property for your environment. For more information on configuration properties, see Appendix A. Standard configuration properties for connectors.

Common Event Infrastructure

This adapter is compatible with Common Event Infrastructure from IBM, a standard for event management that permits interoperability with other IBM WebSphere event-producing applications. If Common Event Infrastructure support is enabled, events produced by the adapter can be received (or used) by another Common Event Infrastructure-compatible application.

For more information, see the Application Response Management appendix in this guide.

Application Response Measurement

This adapter is compatible with the Application Response Measurement (ARM) application programming interface (API), an API that enables applications to be managed for availability, service level agreements, and capacity planning. An ARM-instrumented application can participate in IBM Tivoli(R) Monitoring for Transaction Performance, enabling collection and review of data concerning transaction metrics.

For more information, see the Application Response Measurement appendix in this guide.


1.
If your environment implements the convert-on-the-get methodology for character-set conversions you must download the latest MA88 (JMS classes) from IBM. The patch level should be at least 5.2.2 (for WebSphere MQ version 5.2). Doing so may avoid unsupported encoding errors.

Copyright IBM Corporation 2003, 2005. All Rights Reserved.