MQ ADAPTER Configuration

1. MQ Adapter

1.1 Overview

In our real world applications there would be certain scenario’s where we would be requiring persistence in our applications. There would be certain third party applications which would expose their interaction interfaces in the form of jms Queues. There are certain vendors which have their own jms implementation. IBM is one of them which provides jms implementation in the form of product IBM MQ. IBM MQ Is the IBM implementation of jms concepts. Similarly, we have other vendors which provide their own jms implementation. For ex: Oracle AQ etc. We cannot interact with these different jms implementations directly. We need to write some custom code or an adapter which would serve this purpose and enable intercommunications. Here Oracle provides out of the box adapters which serve the purpose of adapter for communication. We jeust need to configure them.

1.2 Problem Statement

Here we will learn how to configure Oracle MQ Adapter which is provided by Oracle to interact with the IBM MQ.

2. MQ Adapter Configuration

2.1 Overview

This section will guide you how configure MQ adapter to communicate with IBM MQ.

2.2 Steps to Configure MQ-Adapter in JDEV

 

a. Open JDEV and click on file tab and then New.

 

 

 b. You will be presented with a New Gallery Pop-Up.

 

c. Go to the All Technologies tab and select SOA Application on the bottom right hand-side and click Ok.

d. Name your Dialogue will appear. Enter a valid Application Name in Application Name text box. For ex MQAdapterApplication keeping the other values as default values and click on next.

 

 

e. You will be presented with name your project screen. Enter a valid Project name. for ex: MQConfigurationProject and click on next. 

f. You will be presented with Configure SOA settings screen.

 

 

 g. In this page select Composite Template as Empty Composite and click on Finish.

 

 

 

h. A new Application and project will be created and composite.xml will be opened in your editor

 

i. Drag and drop MQ Adapter from component palette to External Reference swim lane in j-Developer. It will open MQ Series Adapter Configuration

 

 

j. Click on Next and you will land to Service Name Page. Enter the valid Service Name and click on Next. For ex: ClientInteractionService. 

 

 

 

k. You will land to MQSeriesConnection page. Specify the MQSeriesConnectionJNDI name and remember this name. We will use this name in server side configuration which will be used to connect to MQ. For ex: eis/MQ/MQSeriesAdapter. After that click on Next.

l. After that you will land to Adapter Interface. Here you have two options either you can define it from an existing WSDL or from schema specified later. In our case we will use Define from operation and schema(specified at a later stage) and click on next.

m. Now you will be presented with OperationType window in which you will have to choose an operation. In our case we will select PutMessageintoMQ operation and click on next.

 n. Next screen is PutMessageintoMQ screen. In QueueName enter the name of the Queue which is configured on MQ server. InQueueManager text enter the name of the QueueManager to which the queue is associated. Keep other fields as default and click on next.

 

o. Next screen is AdvancedOptions screen. Keep all the values to default and click on next.

p. Next screen which is Messages screen will ask you to specify the schema. Browse for the schema and select the message format to put into MQ. In our case it is customerInteractionProcessRequest of clientInteraction.xsd as attached below.

 

q. After selecting the message format click on next.

r. You will be able to see the Finish page. Click on the finish button

s. You will be able to see the MQAdapter Reference component in JDeveloper now