Message Persistence Message Properties

10-44 Oracle Fusion Middleware Users Guide for Technology Adapters An exception report is generated when a message cannot be delivered to the specified destination queue. Exception reports are generated by the message channel. This message report can be selected in the Reports page of the Adapter Configuration page shown in Figure 10–14 . ■ Expiry Report An expiry report indicates that the message was discarded because the expiry time specified for the message elapsed before the message was retrieved. An expiry report is generated by a queue manager. This message report can be selected in the Reports page of the Adapter Configuration page shown in Figure 10–14 . ■ Positive Action Notification A Positive Action Notification PAN indicates that a request has been successfully processed. It means that the action requested in the message has been performed successfully. This type of report is generated by the application. ■ Negative Action Notification A Negative Action Notification NAN indicates that a request has not been successfully serviced. It means that the action requested in the message has not been performed successfully. This type of report is generated by the application. You can specify whether all these report messages except PAN and NAN should contain the complete original message, a part of the original message, or no part of the original message. You can select one of the following options in the Adapter Configuration Wizard: ■ No data from the original message ■ The first 100 bytes of data in the original message ■ The entire original message

10.4.6 Message Delivery Failure Options

The Message Delivery Failure options are supported only for remote queues and not for normal queues. The Oracle MQ Series Adapter enables you to specify the action that should be taken in case a message could not be delivered to the destination queue. You can specify one of the following actions: ■ Place message on a dead letter queue This is the default action. A message is placed on a dead-letter queue if it cannot be delivered to the destination queue. A report message is generated if requested by the sender. ■ Discard message This indicates that the message should be discarded if it cannot be delivered to the destination queue. A report message is generated if requested by the sender. You can specify these options by selecting the Put Message To MQ option in the Adapter Configuration Wizard.

10.4.7 Message Segmentation

The Oracle MQ Series Adapter supports message segmentation for both inbound and outbound interactions. Segmentation is required when the size of a message is greater than the message size allowed for a queue. A physical message is divided into two or more logical messages. All logical messages have the same group ID and a sequence number, and an offset. Oracle JCA Adapter for MQ Series 10-45 In the inbound interaction, the segmentation is inherently supported by the Oracle MQ Series Adapter. The Oracle MQ Series Adapter dequeues all logical messages in the order of sequence number and then publishes the single message as XML to Oracle BPEL PM or Mediator. The Allow Messages to Be Segmented When Necessary option allows you to segment messages for outbound interactions. This option appears in the Response page of the Adapter Configuration Wizard. The message will be segmented based on whether the size of the message is larger than the maximum limit set on the queue.

10.4.8 Integration with CICS

The Oracle MQ Series Adapter provides support for sending and receiving messages from the CICS server. In the inbound direction, an inbound message from the CICS server is dequeued in the same way as a normal message. In the outbound direction, the message should be in the CICS format. A sample schema file for the outbound CICS message format is shown in the following example: ?xml version=1.0 ?schema xmlns=http:www.w3.org2001XMLSchema targetNamespace=http:xmlns.oracle.compcbpelnxsdcics_mqcih elementFormDefault=qualified attributeFormDefault=unqualified xmlns:nxsd=http:xmlns.oracle.compcbpelnxsd nxsd:version=NXSD nxsd:encoding=UTF8 nxsd:stream=bytes nxsd:byteOrder=bigEndian xmlns:nxsd_extn=http:xmlns.oracle.compcbpelnxsdextensions element name=MSGForMQCICSBridge complexType sequence element name=MQCIH complexType sequence -- MQCHAR4 StrucId; Structure identifier -- element name=StrucId type=string nxsd:style=fixedLength nxsd:length=4 nxsd:padStyle=tail -- MQLONG Version; Structure version number 1 or 2 -- element name=Version type=string nxsd:style=integer nxsd_extn:octet=4 nxsd_extn:align=0 nxsd_extn:sign=unticked -- MQLONG StrucLength; Length of MQCIH structure V1=164 V2=180 -- element name=StrucLength type=string nxsd:style=integer nxsd_extn:octet=4