Error Handling Support Oracle AQ Adapter Features

7-12 Oracle Fusion Middleware Users Guide for Technology Adapters Most Common Mistakes The following are the two most common mistakes with deployment: ■ Not creating an adapter instance entry that matches the location attribute in your .jca file or not creating one at all. ■ Setting the location attribute in the .jca file to the name of the data source directly. For the latter, there is a level of indirection in that you give the name of the adapter instance eisAQ..., which itself points to the data source pool jdbc.... It is a common mistake to miss this indirection and give the name jdbc... directly in the location attribute. Additional Adapter Instance Properties There are additional properties in the AQ Adapter instance beyond xADataSourceName, dataSourceName. For information about the Oracle AQ Adapter instance properties, see Appendix A.3, Oracle AQ Adapter Properties.

7.4 Oracle AQ Adapter Use Cases

This section includes the following topics: ■ Section 7.4.1, Generic Use Case ■ Section 7.4.2, Oracle AQ Adapter ADT Queue ■ Section 7.4.3, Oracle AQ Adapter RAW Queue

7.4.1 Generic Use Case

The following use cases include a general walkthrough of the Adapter Configuration Wizard, followed by examples of how you can modify the general procedure in different situations. Each example shows relevant parts of the generated WSDL and JCA files. This section includes the following topics: ■ Section 7.4.1.1, The Adapter Configuration Wizard Walkthrough ■ Section 7.4.1.2, Dequeuing and Enqueuing Object and ADT Payloads ■ Section 7.4.1.3, Dequeuing One Column of the Object Payload ■ Section 7.4.1.4, Configuring the EnqueueDequeue Operation Type ■ Section 7.4.1.5, Using Correlation ID for Filtering Messages During Dequeue ■ Section 7.4.1.6, Enqueuing and Dequeuing from Multisubscriber Queues

7.4.1.1 The Adapter Configuration Wizard Walkthrough

In this example, you will create an Oracle AQ Adapter service that dequeues messages to the service_in_queue queue, with a payload that is one field within the service_type object, and with a user-defined schema. This section describes the tasks required to configure Oracle AQ Adapter by using the Adapter Configuration Wizard in JDeveloper. This section includes the following topics: