My Oracle Support Banner

How to Configure Oracle JMS Adapter with IBM WebSphere MQ JMS with Examples for Global (XA) Transactions (Doc ID 1349263.1)

Last updated on NOVEMBER 22, 2023

Applies to:

Oracle SOA Suite - Version and later
Information in this document applies to any platform.


The purpose of this document is to describe the end-to-end setup and examples, using global XA transactions, for enqueue and dequeue of messages between a WebSphere MQ server and 11g SOA Suite using the JMS adapter. This interaction is commonly known as "Configuring Oracle JMS Adapter with IBM WebSphere MQ JMS" and will be referred to in this article as the MQ-JMS adapter. 

Also discussed are the concepts of MQ Queues and Topics, non-durable and durable subscribers, setup prerequisites, known issues, common errors and solutions.

This article is primarily concerned with SOA Suite versions and above used in conjunction with WebSphere MQ server verison 7.x.

The JDeveloper Composites built below are attached to this article as


To view full details, sign in with your My Oracle Support account.

Don't have a My Oracle Support account? Click to get started!

In this Document
 Discussion of MQ Queues and Topics
 Discussion of MQ Topic Non-durable and Durable Subscribers
 Prerequisites and Other Known Issues in
 End-to-End Examples using Global (XA) Transactions
 (1) Install the MQ Server.
 (2) Enqueue to Topic Example Using XA (With Annotations for Queues)
 (3) Dequeue from Topic Example Using a Durable Subscriber and XA (With Annotations for Queues)

My Oracle Support provides customers with access to over a million knowledge articles and a vibrant support community of peers and Oracle experts.