Oracle File Adapter Configuring Properties for Oracle JCA Adapters

Configuring Service and Reference Binding Components 33-23

33.1.2.6 Oracle MQ Series Adapter

Table 33–8 describes the properties available for the Oracle MQ Series adapter. Reference DurableSubscriber Indicates the unique name of the durable subscription within a client identifier. Reference MessageSelector The message selector expression used for message selection when delivering a message to the destination. Reference ReplyTimeout Indicates the Timeout to receive a reply message. Table 33–8 Oracle MQ Series Adapter Properties Service, Reference, or Endpoint Property Name Description Service MessageType Indicates the message type of the outbounddequeue message. Service QueueName Indicates the name of the inboundoutbound queue. Service UseMessageEncodingForTrans lation Set to true if the character set from header is used during translation. Service InboundThreadCount Indicates the number of threads used in the inbound direction. Service BackoutQueueName Indicates the name of a backout queue in which the rejected message goes. Service BackoutQueueManagerName Indicates the name of the backout queue manager in which the rejected message goes. Service MaximumBackoutCount Indicates the number of times the adapter retries before sending the message to a backout queue. Service BackoutInterval Indicates the interval between a retry for a backout message. Service jca.message.encoding This encoding value overwrites any encoding specified, either in MQMD or in a schema file. Service UseMessageEncodingForTrans lation Set to \true\ if the characterSet field of MQMD is use for translation in the inbound direction. If set to \false\, the translator uses the encoding from the schema file. You can use the jca.message.encoding property to overwrite any encoding specified, either in MQMD or in the schema file. Service FallbackReplyToQueueName Indicates the Fallback Reply To queue name. Service FallbackReplyToQueueManage rName Indicates the Fallback Reply To queue manager name. Service Priority Indicates the priority of the replyoutbound message. Service Expiry Indicates the expiry time for the replyoutbound message. Table 33–7 Cont. Oracle JMS Adapter Service, Reference, or Endpoint Property Name Description 33-24 Oracle Fusion Middleware Administrators Guide for Oracle SOA Suite and Oracle BPM Suite Service Persistence Indicates the persistence of the replyoutbound message. Service Feedback Indicates the feedback code of the replyoutbound message. Note that you cannot edit this property in Oracle Enterprise Manager Fusion Middleware Control. Service MessageFormat Indicates the format of the replyoutbound message. Service OnDeliveryFailure Indicates the behavior of the adapter if replyoutbound message delivery fails. Service SegmentIfRequired Indicates the segmentation property for the message. Service CopyPersistenceFromInbound Indicates the copy persistence from inbound message to reply message in a synchronous request-response inbound scenario. Service PropagateExpiryInterval Indicates the propagate expiry interval from the inbound message to the reply message in a synchronous request-response inbound scenario. Service QueueName Indicates the name of the inboundoutbound queue. Service GetMessageOptions Indicates the Get message options for an outbound dequeue scenario. Service FilterByMsgId Indicates the message ID to use for filtering. Service FilterByCorrelId Indicates the correlation ID to use for filtering. Service FilterByGroupId Indicates the group ID to use for filtering. Service FilterByMsgSeqNumber Indicates the message sequence number to use for filtering. Service FilterByMsgSeqNumber Indicates the message sequence number to use for filtering. Reference QueueName Indicates the name of the inboundoutbound queue. Reference DistributionList Indicates the distribution list in which the message goes. Reference PartialDeliveryForDL Set to false if the message must go to all queues in the DL. Otherwise, it is set to true. Reference SecondaryQueueManagerName Indicates the name of the secondary queue manager. Reference MessageFormat Indicates the format of the replyoutbound message. Reference ReplyMessageId Indicates the correlation scheme for the message ID to be set. Reference ReplyCorrelationId Indicates the correlation scheme for the correlation ID to be set. Reference MessageId Indicates the correlation scheme for the outbound message. Table 33–8 Cont. Oracle MQ Series Adapter Properties Service, Reference, or Endpoint Property Name Description Configuring Service and Reference Binding Components 33-25 Reference CorrelationId Indicates the correlation scheme for the outbound message. Reference ReportCOA Indicates the COA report to be set on the message. Reference ReportCOD Indicates the COD report to be set on the message. Reference ReportException Indicates the exception report to be set on the message. Reference ReportExpiry Indicates the expiration report to be set on the message. Reference ReportPAN Indicates if PAN is required. Reference ReportNAN Indicates if NAN is required. Reference FallbackReplyToQueueName Indicates the Fallback Reply To queue name. Reference FallbackReplyToQueueManage rName Indicates the Fallback Reply To queue manager name. Reference Priority Indicates the priority of the replyoutbound message. Reference Expiry Indicates the expiry time for the replyoutbound message. Reference Persistence Indicates the persistence of the replyoutbound message. Reference Feedback Indicates the feedback code of the replyoutbound message. Reference ReplyToQueueName Indicates the ReplyToQueue to set on the message. Note that you cannot edit this property in Oracle Enterprise Manager Fusion Middleware Control. Reference ReplyToQueueManagerName Indicates the ReplyToQueueManager to be set on the message. Note that you cannot edit this property in Oracle Enterprise Manager Fusion Middleware Control. Reference OnDeliveryFailure Indicates the behavior of the adapter if replyoutbound message delivery fails. Reference SegmentIfRequired Indicates the segmentation property for the message. Reference PartialDeliveryForDL Set to true if partial delivery to the distribution list is allowed. Otherwise, it is set to false. Reference SyncSolicitReqRes Set to true if it is a synchronous request-response outbound scenario. Otherwise, it is set to false. Note that you cannot edit this property in Oracle Enterprise Manager Fusion Middleware Control. Reference ResponseOpaqueSchema Set to true if a replyreport message in a asynchronous request-response scenario has an opaque schema. Table 33–8 Cont. Oracle MQ Series Adapter Properties Service, Reference, or Endpoint Property Name Description 33-26 Oracle Fusion Middleware Administrators Guide for Oracle SOA Suite and Oracle BPM Suite

33.1.2.7 Oracle Socket Adapter

Table 33–9 describes the properties available for the Oracle Socket Adapter. Reference ResponseWaitInterval Indicates the wait time for the replyreport to arrive. Reference ResponseNoMessageAllowed Set to true if no message is allowed as a replyreport after the specified wait interval. Reference ResponseGetMessageOptions Indicates the Get message options for a replyreport. Reference ResponseQueueOpenOptions Indicates the open options for a replyreport queue. Reference PutMessageOptions Indicates the Put message options. Reference QueueOpenOptions Indicates the open options for the queue. Note that you cannot edit this property in Oracle Enterprise Manager Fusion Middleware Control. Reference UseMessageEncodingForTrans lation Set to true if the character set from the header is used during translation. Reference DynamicQueueName Indicates the dynamic queue name. Reference AlternateUserID Indicates the alternate user ID. Reference WaitInterval Indicates the wait interval for the outbound dequeue. Reference NoMessageAllowed Set to true if no message is allowed in the outbound dequeue scenario after a specified wait interval. Reference UseMessageEncodingForTrans lation Set to \true\ if the characterSet field of MQMD is to be used for translation in the inbound direction. If set to \false\, the translator uses the encoding from the schema file. You can use the jca.message.encoding property to overwrite any encoding specified, either in MQMD or in the schema file. Note: Properties such as TransMode and XSLT, which are not listed in Table 33–9 , are displayed in the Properties tab. However, you cannot edit properties that are not listed in Table 33–9 . Making changes to noneditable properties makes the composite invalid and requires remodeling of the composite. Table 33–8 Cont. Oracle MQ Series Adapter Properties Service, Reference, or Endpoint Property Name Description Configuring Service and Reference Binding Components 33-27

33.1.2.8 Oracle JCA Adapters Endpoint Properties

Table 33–10 describes the endpoint properties available for the Oracle JCA Adapters. You cannot add or remove the endpoint properties without redeploying the composite. However, you can change the endpoint properties by using Oracle Enterprise Manager Fusion Middleware Control without redeploying the composite. Table 33–9 Oracle Socket Adapter Properties Service, Reference, or Endpoint Property Name Description Service Port The port on which the inbound socket adapter listens for incoming socket connections. Service Encoding Indicates the character encoding of the native data. Note that you cannot edit this property in Oracle Enterprise Manager Fusion Middleware Control. Service ByteOrder Indicates the byte order of the native data as bigEndian or littleEndian. Note that you cannot edit this property in Oracle Enterprise Manager Fusion Middleware Control. Reference Host Indicates the host to which the outbound socket adapter opens a socket connection. Reference Port Indicates the port to which the outbound socket adapter tries to connect. Reference Encoding Indicates the character encoding of the native data. Note that you cannot edit this property in Oracle Enterprise Manager Fusion Middleware Control. Reference ByteOrder Indicates the byte order of the native data as bigEndian or littleEndian. Note that you cannot edit this property in Oracle Enterprise Manager Fusion Middleware Control. 33-28 Oracle Fusion Middleware Administrators Guide for Oracle SOA Suite and Oracle BPM Suite The following examples show how to specify the endpoint properties in the composite.xml file in Oracle JDeveloper: Table 33–10 Oracle JCA Adapters Endpoint Properties Direction InboundOutbound Property Name Description Inbound activationInstances This property increases the number of polling worker threads for any inbound JCA resource adapter. It is only meant to help increase concurrency scalability for adapters that do not natively support multithreading. Since most of the adapters included with Oracle Fusion Middleware natively support multithreading, this setting is mostly useful to third party custom JCA adapters, which do not natively support multithreading. Set this property to the number of threads required for a particular JCA service endpoint. Inbound UseWorkManager By default, JCA adapters use the standard Oracle Fusion Middleware Oracle WebLogic Server work manager for starting polling worker threads. However, if you want a particular JCA service endpoint to use a custom user-defined work manager, then this property enables you to specify the name of a custom work manager. The work manager is only used to start the JCA Service endpoint for which this property has been defined. Inbound rejectUncorrelatedMes sages When native correlation is used to correlate an inbound asynchronous message with a previous outbound message by way of defining a callback interface for a reference or by a midprocess receive in BPEL, the JCA framework normally tries to post the message to the composite, whether the inbound message can be correlated or not. By setting this property to true, the JCA framework rejects a message, which cannot be correlated when native correlation is active. Inbound jca.retry.count Indicates the maximum number of retries before rejection. Inbound jca.retry.interval Indicates the time interval between retries measured in seconds. Inbound jca.retry.backoff Indicates the retry interval growth factor positive integer. Inbound jca.retry.maxInterval Indicates the maximum value of retry interval; that is, a cap if backoff is greater than 1. Outbound jca.retry.count Indicates the maximum number of retries before throwing a retryable error condition back to the invoking service engine. Outbound jca.retry.interval Indicates the time interval between retries measured in seconds. Outbound jca.retry.backoff Indicates the retry interval growth factor positive integer. Outbound jca.retry.maxInterval Indicates the maximum value of retry intervals; that is, a cap if the backoff is greater than 1. Outbound jca.retry.maxPeriod Indicates the maximum total retry period. Retries do not occur longer than the value specified in this parameter.