Asynchronous Request Reply Pattern

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: Oracle JCA Adapter for JMS 8-45 In the JNDI Properties field, enter datasource=datasource jndi location. Replace the place holder with the JNDI location of your data source. However, if the AQJMS Foreign Server is used by WebLogic application client, then you must configure the JDBC URL with the AQ JMS foreign server you created. ■ JNDI Connection URL : Specify the URL that WebLogic Server will use to contact the JNDI provider. This value is required only if the AQJMS foreign server is used by the WebLogic application client. ■ JNDI Properties Credential: Specify any Credentials that must be set for the JNDI provider. This value is required only if the AQJMS foreign server is used by the Weblogic application client. Adding Connection Factories to the AQ JMS Foreign Server To add connection factories to the AQJMS foreign server: 1. In the Connection Factories tab in the Settings for Foreign Server Name page, click the AQJMS foreign server that you created.

2. Click New.

The Oracle WebLogic Server Administration Console - Create a New Foreign JMS Connection Factory page is displayed.

3. In the Name field, enter a name for this connection factory. This is a logical name

that would be referenced by Oracle WebLogic Server.

4. In the Local JNDI Name field, enter the local JNDI name that you would use in

your application to look up this connection factory.

5. In the Remote JNDI Name field, enter one of the following values depending on

your requirement. If you use this connection factory in a global transaction, then use an XA-based connection factory, else use non-XA based connection factory. ■ QueueConnectionFactory ■ TopicConnectionFactory Note: If you want to use RAC database as adapter endpoint, then the datasource pointed by the JNDI property, mentioned in the preceding step, must point to a multi data source. Individual data sources and multi data sources used for such endpoints must use the recommended setting listed in Section 2.21, Recommended Setting for Data Sources Used by Oracle JCA Adapters. Note: Ensure that you specify aqjmsXAQueueConnectionFactory for local JNDI name if you are connecting to a queue with JNDI name eisaqjmsQueue that is provided with the sample use case, AQQueuetoQueue. Else, specify aqjmsXATopicConnectionFactory if you are connecting to a topic with JNDI name eisaqjmsTopic.