JMS Adapter Limitations When a Remote Server is Used

Oracle JCA Adapter for JMS 8-43 ■ adapters-jms-105-wlsjms-nativecorrelation

8.4.8 AQ JMS Text Message

This use case demonstrates how the Oracle JMS Adapter dequeues from and enqueues to the AQ JMS Queue. You can obtain the adapters-jms-108-aqjms-textmessageusingqueues sample by accessing the Oracle SOA Sample Code site, and selecting the Adapters tab. This section includes the following topics: ■ Section 8.4.8.1, Meeting Prerequisites ■ Section 8.4.8.2, Create an Application Server Connection ■ Section 8.4.8.3, Creating an Application and an SOA Project ■ Section 8.4.8.4, Creating an Inbound Adapter Service ■ Section 8.4.8.5, Creating an Outbound Adapter Service ■ Section 8.4.8.6, Wiring Services and Activities ■ Section 8.4.8.7, Deploying with JDeveloper ■ Section 8.4.8.8, Monitoring Using the Fusion Middleware Control Console

8.4.8.1 Meeting Prerequisites

You must perform the following prerequisites to complete this use case: ■ Section 8.4.8.1.1, Configuring AQ JMS in Oracle WebLogic Server Administration Console ■ Section 8.4.8.1.2, Creating Queues in Oracle Database

8.4.8.1.1 Configuring AQ JMS in Oracle WebLogic Server Administration Console

To configure AQ JMS in Oracle WebLogic Server Administration Console, you must perform the following steps: ■ Adding an Oracle WebLogic JMS Module ■ Adding an AQJMS Foreign Server to the JMS Module ■ Configuring the AQJMS Foreign Server ■ Adding Connection Factories to the AQ JMS Foreign Server ■ Adding Destinations to the AQJMS Foreign Server Adding an Oracle WebLogic JMS Module Note that adding an Oracle WebLogic JMS module is optional. You can also create an AQJMS foreign server in a preexisting JMS module. 1. Navigate to the Oracle WebLogic Server Administration Console: http:servername:portnumberconsole. 2. Use the required credentials to open the Home page of the Oracle WebLogic Server Administration Console. The Home page of the Oracle WebLogic Server Administration Console is displayed.

3. Navigate to Services, Messaging, JMS Modules in the Domain Structure pane.

8-44 Oracle Fusion Middleware Users Guide for Technology Adapters The Oracle WebLogic Server Administration Console - JMS Modules page is displayed.

4. Click New to create a new WebLogic JMS module.

The Oracle WebLogic Server Administration Console - Create JMS System Module page is displayed.

5. Enter a name for the JMS module, and then click Next.

The Oracle WebLogic Server Administration Console - Create JMS System Module page is displayed.

6. Select a target server where your SOA component is running, and then click Next.

The Oracle WebLogic Server Administration Console - Create JMS System Module page is displayed.

7. Click Finish.

You have created a JMS module. Adding an AQJMS Foreign Server to the JMS Module The next step is to add an AQ JMS foreign server to the JMS module by performing the following: 1. Click the JMS module that you created. The Oracle WebLogic Server Administration Console - Settings for AQJMSModule page is displayed.

2. Click New in the Summary of Resources table to create a new JMS system module

resource. The Oracle WebLogic Server Administration Console - Create a New JMS System Module Resource page is displayed.

3. Under Choose the type of resource you want to create, select Foreign Server, and

then click Next. The Oracle WebLogic Server Administration Console - Create a New JMS System Module Resource page is displayed.

4. In the Name field, enter a name for the foreign server, and then click Finish.

The Oracle WebLogic Server Administration Console - Settings for JMS Module Name page is displayed. Configuring the AQJMS Foreign Server The next step is to configure the AQJMS foreign server that you created: 1. Click the AQ JMS Foreign Server listed under the Summary of Resources table. The Oracle WebLogic Server Administration Console - Settings for TestAQJMS_ ForeignServer page is displayed. 2. Enter the following values: ■ JNDI Initial Context Factory : oracle.jms.AQjmsInitialContextFactory If the AQJMS Foreign Server is used by the WebLogic server side components, then you must configure a data source with this AQ JMS Foreign Server, by specifying the following values: