A Create the JMS Topic for the FulfillmentBatch Adapter

This appendix complements Section 6.4, "Creating the Services and Routing Required for the Scope_FulfillOrder Scope." It contains the following tasks:

• Section A.1, "Task 1: Create the JMS Topic"

• Section A.2, "Task 2: Create the JMS Topic Connection Factory"

• Section A.3, "Task 3: Add the Connection Pool"

A.1 Task 1: Create the JMS Topic

The DemoSupplierTopic topic defines a publish and subscribe destination type, which is used for asynchronous peer communications.

To create it through the Oracle WebLogic Server Administration Console.

1. Access the Oracle WebLogic Server Console from the following URL:

   http://hostname:port/console
   

   where is the hostname is the DNS name or IP address of the Administration Server for Oracle SOA Suite and port is the DNS name or IP address of the Administration Server and port is the address of the port on which the Administration Server is listening for requests (7001 by default).

2. When the login page appears, enter the user name and the password you used to start the Administration Server (you may have specified this user name and password during the installation process), or enter a user name that is granted a default global security role.

3. Click Log In.

4. In the Administration Console, from the navigation pane, expand Services > Messaging and select JMS Modules.

5. On the JMS Modules page, select SOAJMSModule.

6. On the Settings for SOAJMSModule page, in the Summary of Resources table, select New.

7. On the Create a New JMS System Module Resource page, select Topic and then Next.

8. In the JMS Destination Properties section, enter the following details:

   Element	Value
   Name	DemoSupplierTopic
   JNDI Name	jms/DemoSupplierTopic

   
   
   
   Description of the illustration jms.gif
   
   

9. Click Next.

10. From the Subdeployments list, select SOASubDeployment.

11. From the JMS Servers table, select SOAJMSServer, and then click Finish.

    The Summary of Resources table now displays the topic DemoSupplierTopic.

A.2 Task 2: Create the JMS Topic Connection Factory

To add the connection factory, which defines a set of connection configuration parameters to create connections for JMS clients:

1. On the Settings for SOAJMSModule page, in the Summary of Resources table, select New again.

2. On the Create a New JMS System Module Resource page, select Connection Factory and then Next.

3. In the Connection Factory Properties section, enter the following details:

   Element	Value
   Name	DemoSupplierTopicCF
   JNDI Name	jms/DemoSupplierTopicCF

   
   
   
   Description of the illustration jmsconfac.gif
   
   

4. Click Next.

5. Click Finish.

   On the Settings for SOAJMSModule page, the Summary of Resources table now displays both the DemoSupplierTopic topic and the connection factory DemoSupplierTopicCF.

   
   Description of the illustration jmsconfac2.gif
   
   

A.3 Task 3: Add the Connection Pool

A connection pool is configured in the JMSAdapter application.

To add a connection pool:

1. The JMSAdapter application uses a deployment plan. Create a directory for deployment plan in the following directory:

   (UNIX) MW_HOME/soa/JSMPlan
   (Windows) MW_HOME\soa\JSMPlan
   

2. In the Administration Console, from the navigation pane, select Deployments.

3. On the Summary of Deployments page, from the Deployments table, select the JmsAdapter link.

4. On the Settings for JmsAdapter page, select the Configuration tab and then the Outbound Connection Pools sub-tab.

5. From the Outbound Connection Pool Configuration table, click New.

6. From the Outbound Connection Groups table, select oracle.tip.adapter.jms.IJmsConnectionFactory, and then click Next.

   
   Description of the illustration jmsconfac3.gif
   
   

7. In the JNDI Name field, enter eis/Jms/TopicConnectionFactory.

8. Click Finish.

9. When prompted to select a deployment plan, perform the following steps:

   1. In the Path field, select the path to the directory you created in Step 1 and enter Plan.xml after the path.

      If there is a plan file selected with the option at the top of the page, the one you enter takes precedence.

   2. Click OK.

   3. Verify the plan name is set to Plan.xml in the JMSPlan directory.

10. Select the Configuration tab.

11. Expand the select oracle.tip.adapter.jms.IJmsConnectionFactory, and select eis/Jms/TopicConnectionFactory

12. For the following rows, select the Property Value cell on the far right, modify the value as specified, and then press Enter.

    Row	Property Value
    ConnectionFactoryLocation	jms/DemoSupplierTopicCF
    IsTopic	true
    Username	The Oracle WebLogic Server administrator. For example: weblogic
    Password	The password of the Oracle WebLogic Server weblogic user. For example: welcome1

    
    

13. Click Save.

14. Redeploy the adapter:

    1. From the navigation pane, select Deployments.

       The Summary of Deployments page displays with the Deployments table.

    2. Select the check box next to the JmsAdapter, and then click Update.

    3. In the Update Application Assistant page, click Redeploy this application using the following deployment file.

    4. Click Next.

    5. Click Finish.