Adding jar Files to the Oracle MQ Series Adapter Classpath: MQ Series 6 and 7 Adding JNDI Entry

Oracle JCA Adapter for MQ Series 10-55 Figure 10–32 Settings of MQSeriesAdapter Page

4. Click the Configuration tab. The Configuration sub-menu options are displayed,

as shown in Figure 10–33 . Figure 10–33 Settings of MQSeriesAdapter Page - Configuration Sub-Menu Options

5. Click Outbound Connection Pools. The Outbound Connection Pool

Configuration Table is displayed, as shown in Figure 10–34 . Figure 10–34 Outbound Connection Pool Configuration Table

6. Click New. The Create a New Outbound Connection page is displayed, as shown

in Figure 10–35 . 10-56 Oracle Fusion Middleware Users Guide for Technology Adapters Figure 10–35 Create a New Outbound Connection Page

7. Select the javax.resource.cci.ConnectionFactory option, and click Next.

8. Enter a value in the JNDI Name field, for example eisMQMQAdapter, as shown in Figure 10–36 . Figure 10–36 Create a New Outbound Connection Page - JNDI Name

9. Click Finish. The Save Deployment Plan Assistant page is displayed.

10. Click OK. You have successfully created a JNDI name.

10.5.3 Enabling Binding Mode for Connections

You can enable binding mode for connections for the Oracle MQ Series Adapter by modifying a few properties in the Oracle WebLogic Server Administration Console: To enable binding mode, perform the following steps: 1. Log in to the Oracle WebLogic Server Administration Console using your password credentials.

2. Under Domain Structure, in the left pane, click Deployments. The Summary of

Deployments page is displayed.

3. Click MQSeriesAdapter. The Settings of MQSeriesAdapter page is displayed.

4. Click the Configuration tab. The Configuration sub-menu options are displayed.

5. Click Outbound Connection Pools. The Outbound Connection Pool

Configuration Table is displayed. 6. Click the + icon next to javax.resource.cci.ConnectionFactory. A list of JNDIs are displayed. Oracle JCA Adapter for MQ Series 10-57

7. Select, eisMQMQAdapter, the JNDI that you created in the

Section 10.5.2, Adding JNDI Entry . The Outbound Connection Properties page is displayed, as shown in Figure 10–37 , with a list of 24 properties. Figure 10–37 Outbound Connection Properties Page 8. Set the following parameters as mentioned below: ■ hostName : This value should always be blank. ■ portNumber : This value should contain some unused port numbers. For example, 44888. ■ channelName : This value should always be blank. ■ queueManagerName : This value is a valid queue manager name. You have enabled the binding mode for connections for the Oracle MQ Series Adapter.

10.6 Oracle MQ Series Adapter Use Cases

This section contains the following topics: ■ Section 10.6.1, Dequeue Enqueue ■ Section 10.6.2, Inbound Synchronous Request-Reply ■ Section 10.6.3, Inbound-Outbound Synchronous Request-Reply ■ Section 10.6.4, Asynchronous-Request-Reply ■ Section 10.6.5, Outbound Dequeue ■ Section 10.6.6, Using RFH2 Headers ■ Section 10.6.7, Configuring a Backout Queue

10.6.1 Dequeue Enqueue

This use case is the end-to-end demonstration of how MQ Adapter dequeues a message and enqueues the same message after transformation from the MQ Series queue. This section contains the following topics: ■ Section 10.6.1.1, Prerequisites ■ Section 10.6.1.2, Designing the SOA Composite 10-58 Oracle Fusion Middleware Users Guide for Technology Adapters ■ Section 10.6.1.3, Creating an Inbound Adapter Service ■ Section 10.6.1.4, Creating an Outbound Adapter Service ■ Section 10.6.1.5, Wiring Services and Activities ■ Section 10.6.1.6, Deploying with JDeveloper ■ Section 10.6.1.7, Monitoring Using the Oracle Enterprise Manager Fusion Middleware Control Console Fusion Middleware Control Console

10.6.1.1 Prerequisites

To perform the dequeue enqueue use case, you need the following files from the artifacts.zip file contained in the Adapters-101MQAdapterDequeueEnqueue sample: ■ artifactsschemasaddress-csv.xsd ■ artifactsschemasaddress-fixedLength.xsd ■ artifactsinputdata.txt You can obtain the Adapters-101MQAdapterDequeueEnqueue sample by accessing the Oracle SOA Sample Code site, and selecting the Adapters tab. You must also create the following queues: ■ test_in ■ test_out

10.6.1.2 Designing the SOA Composite

You must create a JDeveloper application to contain the SOA composite. To create an application and a project for the use case, perform the following:

1. In JDeveloper, click File and select New.

The New Gallery dialog is displayed.

2. Expand the General node, and select the Applications category.

3. In the Items list, select Generic Application and click OK. The Create Generic

Application Wizard is displayed. 4. In the Name Your Application screen, enter De-queueEn-queue in the Application Name field, as shown in Figure 10–38 , and then click Next. The Name Your Project screen is displayed.