Inbound Rejection Handler Performance Tuning

Oracle JCA Adapter for MQ Series 10-15 For more information about configuring Backout Queues, see Section 10.6.7, Configuring a Backout Queue.

10.3.10 Performance Tuning

The Oracle MQ Series Adapter supports performance tuning options. For more information, see Oracle MQ Adapter Tuning in the Oracle Fusion Middleware Performance and Tuning Guide.

10.4 Oracle MQ Series Adapter Concepts

This section explains the following concepts of the Oracle MQ Series Adapter: ■ Section 10.4.1, Messaging Scenarios ■ Section 10.4.2, Message Properties ■ Section 10.4.3, Correlation Schemas ■ Section 10.4.4, Distribution List Support ■ Section 10.4.5, Report Messages ■ Section 10.4.6, Message Delivery Failure Options ■ Section 10.4.7, Message Segmentation ■ Section 10.4.8, Integration with CICS ■ Section 10.4.9, Supported Encodings

10.4.1 Messaging Scenarios

The Oracle MQ Series Adapter supports the following messaging scenarios: ■ Section 10.4.1.1, Enqueue Message ■ Section 10.4.1.2, Dequeue Message ■ Section 10.4.1.3, Asynchronous Request-Response Oracle BPEL PM As Client ■ Section 10.4.1.4, Synchronous Request-Response Oracle BPEL PM As Server ■ Section 10.4.1.5, Asynchronous Request-Response Oracle BPEL PM As Server ■ Section 10.4.1.6, Synchronous Request-Response Mediator As Server ■ Section 10.4.1.7, Synchronous Request-Response Oracle BPEL PM As Client ■ Section 10.4.1.8, Synchronous Request-Response Oracle Mediator as Client ■ Section 10.4.1.9, Asynchronous Request-Response Oracle Mediator As Client ■ Section 10.4.1.10, Outbound Dequeue Scenario Note: When using the Backout Queue, consider the following: ■ The Backout Queue options cannot be used for translation failures. ■ In cases where both JCA and BackOut retries are specified, the BackOut retries takes precedence. 10-16 Oracle Fusion Middleware Users Guide for Technology Adapters

10.4.1.1 Enqueue Message

In this scenario, the Oracle MQ Series Adapter connects to a specific queue managed by a queue manager and then writes the message to the queue. For outbound messages sent from Oracle BPEL PM or Mediator, the Oracle MQ Series Adapter performs the following operations:

1. Receives message from Oracle BPEL PM or Mediator.

2. Formats the XML content as specified at design time.

3. Sets the properties of the message, such as priority, expiry, message type, and

persistence. These properties are based on the selections that you made in the Adapter Configuration Wizard. For more information about message properties, see Section 10.4.2.1, Messages Types .

4. Sends the message to the queue specified at design time in the Adapter

Configuration Wizard. Figure 10–7 displays the operation type that you must select in the Adapter Configuration Wizard. Figure 10–7 The Adapter Configuration Wizard: Produce Message Selection The page that appears after selecting the Put Message into MQ operation type is shown in Figure 10–8 . Oracle JCA Adapter for MQ Series 10-17 Figure 10–8 Put Message Options You can specify the following properties in this page: ■ Queue Name : The name of the queue on which the Oracle MQ Series Adapter will enqueue the message. This is a mandatory field. ■ Queue Manager : The name of the queue manager to which the queue belongs. This field is optional and should be used when enqueuing message to a remote queue. ■ Partial Delivery : This is applicable only when you specify more than one queue for outbound operation, which is also known as the Distribution List scenario. Partial Delivery takes either true or false. If assigned true, then even if the delivery of message fails for some queues, it would still go and put the message to the rest of the queues specified in the distribution list. If assigned false, it means even if one message fails, then the message is not put to any queue. ■ Message Format : The format of the message. ■ Priority : The priority of the message, ranging from 0 low to 9 high. ■ Persistence : The persistence of the message. You can also specify the persistence of the message to be taken from the default persistence attribute, as defined by the destination queue. ■ Delivery Failure : If the delivery of message fails, then either it can be put to a dead letter queue or it can be discarded. ■ Allow Messages to Be Segmented When Necessary : This is applicable to a message that is big enough for the queue to accommodate. In that case, if you have Note: When enqueuing a message, ensure that the various mandatory values, required for a specific format, are specified correctly.