Oracle Database Adapter Configuring Properties for Oracle JCA Adapters

Configuring Service and Reference Binding Components 33-19 Service notifyEachBatchFailure Setting to \true\ causes the fileFTP adapter to call the notification agents onBatchFailure every time an error occurs in a debatching scenario. If set to \false\, the fileFTP adapter calls onBatchFailure only once after all messages in the debatching scenario. Reference PhysicalDirectory The directory path for the fileFTP adapter. Reference FileType Set it to either \ascii\ or \binary\, depending on the requirement. Reference NumberMessages This parameter is used for outbound batching. The outgoing file is created when the number of messages condition is met. The parameter is of type String and is not mandatory. The default value is 1. Reference ElapsedTime This parameter is used for outbound batching. When the time specified elapses, the outgoing file is created. The parameter is of type String and is not mandatory. The default value is 1. Reference FileSize This parameter is used for outbound batching. The outgoing file is created when the file size condition is met. The parameter is of type String and is not mandatory. The default value is 1000 KB. Reference FileNamingConvention This parameter is for the naming convention of the outbound write operation file. Reference FileName Use this parameter to specify a static single file name during the write operation. Reference Append Setting this parameter to \true\ causes the fileFTP adapter to append to a file in the outbound direction. If the file does not exist, a new file is created. Reference UseStaging If \true\, then the outbound fileFTP adapter writes translated data to a staging file and afterward streams the staging file to the target file. If \false\, then the outbound fileFTP adapter does not use an intermediate staging file. Reference ConcurrentThreshold The maximum number of translation activities allowed to execute in parallel for a particular outbound scenario. The translation step during the outbound operation is CPU intensive and must to be guarded as it may cause starvation in other applicationsthreads. The maximum value is 100 same as the maximum value for dspMaxThreads in BPEL. Reference SequenceName Specifies the Oracle database sequence name to use if you have already configured the outbound fileFTP adapter for high availability. Reference oracle.tip.adapter. file.mutex Set it to the class name that specifies the mutex you want to use for the outbound write operation. This class must extend the \oracle.tip.adapter.file.Mutex\ abstraction. Table 33–6 Cont. Oracle FTP Adapter Properties Service, Reference, or Endpoint Property Name Description 33-20 Oracle Fusion Middleware Administrators Guide for Oracle SOA Suite and Oracle BPM Suite Reference serializeTranslation If set to \true\, then the translation step is serialized using a semaphore. The number of permits for semaphore guarding the translation step comes from the ConcurrentThreshold parameter. If \false\, then the translation step occurs outside the semaphore. Reference inMemoryTranslation This parameter is applicable only if UseStaging is \false\. If set to \true\, then the translation step occurs in-memory that is, an in-memory byte array is created. If set to \false\, then the adapter creates an output stream to the target file FTP, FTPS, and SFTP included and allows the translator to translate and write directly to the stream. Reference FileType Set it to either \ascii\ or \binary\, depending on the requirement. Reference UseRemoteArchive Set this parameter to \true\ to notify the FTP adapter that the archival directory is on the same FTP server. If set to \false\, the FTP adapter uses a local file system folder for archival. Reference DeleteFile If set to \true\, the fileFTP adapter deletes the file after it has been processed. Reference IgnoreZeroByteFile Set it to \true\ if you do not want the fileFTP adapter to throw an exception during the outbound read operation if the file was not found. This parameter is ignored if the schema for the inbound file is anything other than \Opaque\. Reference IncludeFiles Indicates the regex pattern against which the file names are matched. If the name of a certain file matches this pattern, it is processed by the fileFTP adapter. Reference ExcludeFiles Indicates the regex pattern against which the file names are matched. If the name of a certain file matches this pattern, it is excluded and not processed by the fileFTP adapter. Reference Recursive If set to \true\, the fileFTP adapter processes files recursively in subdirectories. Reference MaxRaiseSize This parameter specifies the maximum number of files that the fileFTP adapter submits for processing in each polling cycle. For example, if the inbound directory has 1000 files and this parameter is set to 100 and the polling frequency is one minute, the fileFTP adapter submits 100 files every minute. Reference DirectorySeparator When you choose multiple directories, the generated JCA files use \;\ as the separator for these directories. If you want, you can change the separator. If you do, manually add DirectorySeparator=\chosen separator\ in the generated JCA file. For example, to use a comma , as the separator, you must first change the separator to \,\ in the physical directory and then add DirectorySeparator=\,\ in the JCA file. Table 33–6 Cont. Oracle FTP Adapter Properties Service, Reference, or Endpoint Property Name Description Configuring Service and Reference Binding Components 33-21

33.1.2.5 Oracle JMS Adapter

Table 33–7 describes the properties available for the Oracle JMS adapter. Reference UseNlst Set this parameter to \true\ if you need the FTP adapter to use the \NLST\ FTP command instead of \LIST\ that the adapter uses by default. Reference timestampOffset This parameter is used by the FTP adapter to tackle time zone issues typically, to convert the time difference between the FTP server and the system on which the FTP adapter is running to milliseconds. Reference SourceFileName Indicates the source file for the file IO operation. Reference SourcePhysicalDirectory Indicates the source directory for the file IO operation. Reference SourceType Set this to \native\ if the source file is native and to \xml\ if the source file is XML. Reference SourceSchema Set it to the schema for the source file. Reference SourceSchemaRoot Set it to the root element name for the source file. Reference TargetFileName Indicates the target file for the file IO operation. Reference TargetPhysicalDirectory The target directory for the file IO operation. Reference TargetType Set this to \native\ if the target file is native and to \xml\ if the source file is XML. Reference TargetSchema Set it to the schema for the target file. Reference TargetSchemaRoot Set it to the root element name for the target file. Reference Xsl Set it to the XSL transformer between the source and target. Reference Type Set it to either \ascii\ or \binary\, depending on the requirement. Reference BatchSize Set it to the batch size for the batching transformation. Reference SourceIsRemote Set it to \false\ to notify the FTP adapter that the source for the IO operation is a local file system as opposed to a remote FTP server. Reference TargetIsRemote Set it to \false\ to IO notify the FTP adapter that the target for the IO operation is a local file system as opposed to a remote FTP server. Reference ChunkSize Set it to the ChunkSize for the chunked interaction operation. Table 33–6 Cont. Oracle FTP Adapter Properties Service, Reference, or Endpoint Property Name Description 33-22 Oracle Fusion Middleware Administrators Guide for Oracle SOA Suite and Oracle BPM Suite Table 33–7 Oracle JMS Adapter Service, Reference, or Endpoint Property Name Description Service adapter.jms.encoding Set the encoding to be used by JMS inbound adapter. Service adapter.jms.receive.timeout Set the receive timeout interval. Service adapter.jms.retry.interval Set the interval the JMS adapter uses to retry. Service adapter.jms.registration. interval Set the registration interval. Service adapter.jms.receive.threads Set the number of receive threads. Service JMSReplyTo DestinationProperties Set the reply-to destination. Service JMSReplyUse MessageIdForCorrelation Specifies whether the message ID is necessary for correlation. Valid values are true or false. Service JMSReplyUseCorrelation IdForCorrelation Specifies whether the correlation ID is necessary for correlation. Valid values are true or false. Service suppressHeaders Specifies whether to bypass headers. Valid values are true or false. Service JMSReply PropagateJMSExpiration Specifies whether a reply message is created with a TTL value of other than 0, which is the default value in a request-reply scenario. Valid values are true or false. Service minimumDelayBetweenMessages This is a throttling parameter in milliseconds that adds a brief sleep period between each inbound posted message, thus slowing down the message inflow. Reference requestReply.useCorrelation Specifies whether correlation is necessary in a request-reply scenario. Valid values are true or false. Reference requestReply.cacheReceivers Specifies whether correlation is necessary in a request-reply scenario. Valid values are true or false. Reference DestinationName The name of the JMS physical destination. Reference PayloadType Indicates the JMS message type. Reference DeliveryMode Sets the JMS delivery mode. Delivery modes supported by JMS API are PERSISTENT and NON_PERSISTENT. Reference TimeToLive Indicates the message lifetime in milliseconds. Reference Priority Indicates the JMS message priority. Reference PayloadEntry Specifies the MapMessage entry to use as the payload. Reference AttachmentList Specifies the MapMessage entry to use as the payload and publish as an attachment. Reference RequestDestinationName Indicates the name of the JMS physical destination. Reference ReplyDestinationName Indicates the name of the JMS physical destination. Reference AllowTemporaryReplyDestination Allows creation of a temporary destination for receiving messages. 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