Thank you for your feedback!

- best for offline viewing and printing

ePub

- best for most mobile devices

Mobi

- best for Amazon Kindle devices

33 Configuring Service and Reference Binding Components

This chapter describes how to configure properties for web service and JCA adapter service and reference binding components that are included in SOA composite applications. Binding components are network protocols and services that connect the SOA platform with the outside world.

This chapter includes the following topic:

Section 33.1, "Configuring Service and Reference Binding Component Properties"

For more information about binding components, see the following documentation:

Notes:

You cannot configure message header properties for direct binding components that invoke a SOA composite application through a remote RMI call. For this reason, the Properties tab does not display for direct binding components.
You cannot change the httpBinding property for the HTTP binding component.
Support is provided for adding MTOM attachments to web services. For more information, see Oracle Fusion Middleware Developer's Guide for Oracle SOA Suite.

33.1 Configuring Service and Reference Binding Component Properties

You can configure message header properties for the service and reference binding components included in a deployed SOA composite application.

To configure service and reference binding component properties:

Access this page through one of the following options:

From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...	From the SOA Composite Menu...
Select Services and References. Select a specific service or reference. Click the Properties tab.	Right-click soa-infra. Select Services and References. Select a specific service or reference. Click the Properties tab.	Select Services/Reference Properties. Select a specific service or reference. Click the Properties tab.

The following binding component properties appear for a web service.

Description of the illustration bc_properties.gif Opens a new window

The following binding component properties appear for a file adapter. Depending upon your selection of JCA adapter, different parameters display for configuring.

Description of the illustration bc_properties2.gif Opens a new window

Change properties based on your selection of binding component. See sections Section 33.1.1, "Configuring Properties for Web Services" and Section 33.1.2, "Configuring Properties for Oracle JCA Adapters" for available properties.

Note:
To see adapter header properties and their values on this page, ensure that you change the value of the Audit Level property from Production (the default) to Development in the SOA Infrastructure Common Properties page. If this property is set to Production, the properties and their values do not display.

33.1.1 Configuring Properties for Web Services

Table 33-1 Opens a new window describes the properties available for a web service binding component.

Table 33-1 Web Service Properties

Service, Reference, or Endpoint	Property Name	Description
Service	REST Enabled	Enable or disable the web services port to accept messages in Representational State Transfer (REST) format.
Service	WSDL Enabled	Enable or disable the WSDL of the web service.
Service	Metadata Exchange Enabled	Enable or disable a metadata exchange of the web service.
Service	Endpoint Test Enabled	Enable or disable an endpoint test of the web service.
Service	Logging Level	Select the level of logging to perform on the web service.
Service	Schema Validation	Enable or disable schema validation.
Service	Atomic Transaction Version	Select the WS-AtomicTransaction (WS-AT) supported version (1.0, 1,1, 1,2, or default).
Service	Atomic Transaction Flow Option	Select the transaction participation value: Never No transaction context is imported (for services) or exported (for references). Supports If a transaction exists, a transaction context is imported (for services) or exported (for references). This information is added to the `composite.xml` file. Mandatory A transaction context is imported (for services) or exported (for references). For exports, a web service exception message is thrown if there is no active transaction. For imports, a fault is returned to the client if there is no transaction context in the request.
Service	Maximum Request Size	Enter the maximum request size of the web service. A value of `-1` indicates the size is unlimited.
Service	Unit of Maximum Request Size	Select the request unit of the web service (either bytes, kilobytes, megabytes, or gigabytes).

33.1.2 Configuring Properties for Oracle JCA Adapters

Note that if you manually add a nonregistered JCA binding level property in the composite.xml file, then you cannot subsequently edit that property or also any other registered properties for that service or reference through Oracle Enterprise Manager Fusion Middleware Control. Table 33-2 Opens a new window describes the JCA adapter property types.

Table 33-2 Types of JCA Adapters

Property Type Description Restrictions

Property Type	Description	Restrictions
Activation specification and interaction specification	Activation specification properties operate as services and interaction specification properties operate as references in a SOA composite application.	Do not add or remove these properties. You can only change their values. These properties require the adapter endpoint to be recycled. These types of properties are also dependent upon other properties. If you attempt to add one of these properties, you have no way of knowing which dependent properties must also be added.
Endpoint	These are tuning-related properties that are not exposed through the activation or interaction specification properties, such as specifying time outs, thresholds, maximum intervals, and so on.	There are no restrictions on adding, removing, or changing endpoint properties. The adapter is notified when these properties are added, removed, or changed, but it does not require redeployment. Note that you cannot add or remove `jca.retry.*` endpoint properties without redeploying the composite. However, you can change these properties by using Oracle Enterprise Manager Fusion Middleware Control without redeploying the composite.

Activation specification and interaction specification

Activation specification properties operate as services and interaction specification properties operate as references in a SOA composite application.

Do not add or remove these properties. You can only change their values.

These properties require the adapter endpoint to be recycled. These types of properties are also dependent upon other properties. If you attempt to add one of these properties, you have no way of knowing which dependent properties must also be added.

Endpoint

These are tuning-related properties that are not exposed through the activation or interaction specification properties, such as specifying time outs, thresholds, maximum intervals, and so on.

There are no restrictions on adding, removing, or changing endpoint properties. The adapter is notified when these properties are added, removed, or changed, but it does not require redeployment.

Note that you cannot add or remove jca.retry.* endpoint properties without redeploying the composite. However, you can change these properties by using Oracle Enterprise Manager Fusion Middleware Control without redeploying the composite.

This section includes the following topics:

Section 33.1.2.1, "Oracle AQ Adapter"
Section 33.1.2.2, "Oracle Database Adapter"
Section 33.1.2.3, "Oracle File Adapter"
Section 33.1.2.4, "Oracle FTP Adapter"
Section 33.1.2.5, "Oracle JMS Adapter"
Section 33.1.2.6, "Oracle MQ Series Adapter"
Section 33.1.2.7, "Oracle Socket Adapter"
Section 33.1.2.8, "Oracle JCA Adapters Endpoint Properties"

33.1.2.1 Oracle AQ Adapter

Table 33-3 Opens a new window describes the properties available for the Oracle AQ Adapter.

Table 33-3 Oracle AQ Adapter Properties

Service, Reference, or Endpoint	Property Name	Description
Service	`DequeueTimeOut`	Sets the dequeue timeout interval.
Service	`ConnectionRetryDelay`	Sets the connection retry interval.
Service	`adapter.aq.dequeue.threads`	The number of dequeue threads.
Service	`jca.retry.count`	The number of retries to post the message.
Service	`jca.retry.interval`	The time interval between message retries.
Service	`QueueName`	Indicates the AQ queue name.
Service	`DatabaseSchema`	Database schema name that hosts the queue.
Service	`SchemaValidation`	Validates the message payload.
Service	`ObjectFieldName`	Specifies the ADT entry used as a payload. Note that you cannot edit this property in Oracle Enterprise Manager Fusion Middleware Control.
Service	`PayloadHeaderRequired`	Specifies if the ADT entries, except for the payload, are accessible.
Service	`DequeueCondition`	Specifies the expression to dequeue messages.
Service	`Consumer`	Specifies the consumer of a queue.
Service	`MessageSelectorRule`	Specifies the message selector to dequeue messages.
Service	`StreamPayload`	Specifies if the payload is streamed or not.
Service	`Correlation`	Specifies a correlation criterion or search criterion for the dequeue operation. For the enqueue operation, the value becomes the correlation of the message sent to AQ.
Reference	`Username`	Identifies a user name requesting access to a secure environment or program, such as an Oracle database or Oracle applications system.
Reference	`Responsibility`	Specifies a collection of functions within Oracle E-Business Suite. Each user is assigned one or more responsibilities to allow access to the appropriate functions and data.
Reference	`QueueName`	Indicates an AQ queue name.
Reference	`DatabaseSchema`	Indicates the database schema name that hosts the queue.
Reference	`ObjectFieldName`	Specify the ADT entry to use as a payload. Note that you cannot edit this property in Oracle Enterprise Manager Fusion Middleware Control.
Reference	`PayloadHeaderRequired`	Specify if ADT entries, except for the payload, are accessible.
Reference	`RecipientList`	Specify recipient of the messages.
Reference	`Correlation`	Specifies a correlation criterion or search criterion for the dequeue operation. For the enqueue operation, the value becomes the correlation of the message sent to AQ.

33.1.2.2 Oracle Database Adapter

Table 33-4 Opens a new window describes the properties available for the Oracle Database adapter.

Table 33-4 Oracle Database Adapter Properties

Service, Reference, or Endpoint	Property Name	Description
Service	`DescriptorName`	The key into the TopLink metadata indicating the root relational table. Note that you cannot edit this property in Oracle Enterprise Manager Fusion Middleware Control.
Service	`QueryName`	The key into the TopLink metadata indicating the named query to execute, with predefined `where` clause and parameters. Note that you cannot edit this property in Oracle Enterprise Manager Fusion Middleware Control.
Service	`MappingsMetaDataUR`	In conjunction with `MappingsMetaDataURL`, the path to the TopLink metadata file that describes how a database schema has been mapped to a particular predefined XML schema. Note that you cannot edit this property in Oracle Enterprise Manager Fusion Middleware Control.
Service	`MappingsMetaDataUR`	Indicates the path to the TopLink metadata file that describes how a database schema has been mapped to an XML schema. Note that you cannot edit this property in Oracle Enterprise Manager Fusion Middleware Control.
Service	`OXMappingsMetaDataURL`	In conjunction with `MappingsMetaDataURL`, the path to the TopLink metadata file that describes how a database schema has been mapped to a particular predefined XML schema. Note that you cannot edit this property in Oracle Enterprise Manager Fusion Middleware Control.
Service	`PollingInterval`	Indicates the number of seconds between queries to the database for new events.
Service	`MaxRaiseSize`	Indicates the maximum number of XML records that can be raised at a time to Oracle BPEL Process Manager or the activation listener.
Service	`PollingStrategy`	Indicates the method in which events are raised from the database. This is also known as `AfterReadStrategy`. Note that you cannot edit this property in Oracle Enterprise Manager Fusion Middleware Control.
Service	`MarkReadColumn`	Indicates the status column used by `LogicalDeletePollingStrategy` for indicating which rows have been processed.
Service	`MarkUnreadValue`	The status of unprocessed rows.
Service	`MarkReservedValue`	The status of rows reserved by this polling instance.
Service	`MarkReadValue`	The status of processed rows.
Service	`SequencingTableName`	For example, `DB_ADAPTER_SEQUENCING`.
Service	`SequencingTableKeyColumn`	For example, `TABLE_NAME`. This column holds the primary keys of the various sequences stored.
Service	`SequencingTableValueColumn`	For example, `LAST_READ_ID`. This is the column that holds the value of the last processed sequence value.
Service	`SequencingColumn`	This is the monotonically increasing column on the polled table. For example, `SCOTT.EMP.EMP_ID`.
Service	`SequencingColumnType`	This is the type of sequence counter used. For example, the `java.math.BigDecimal, java.sql.Timestamp`.
Service	`SequencingTableKey`	For example, the `SCOTT.EMP`. This is the key into the sequencing helper table, usually the name of the table being polled.
Service	`ShouldCacheSequenceValue`	For `SequencingPollingStrategy`, the `lastReadId` can be kept in-memory so it does not have to be read at the start of each polling interval.
Service	`ShouldWriteSequenceValue`	For `SequencingPollingStrategy`, the `lastReadId` can be kept in-memory and only written out to disk or a database when the process, application server, or both are shut down.
Service	`DeleteDetailRows`	For the delete polling strategy, this indicates whether to delete detail rows and master rows after XML records have been read.
Service	`SequencingDataSourceName`	For `ExternalSequencingPollingStrategy`.
Service	`SequencingIsXADataSource`	For `ExternalSequencingPollingStrategy`.
Service	`UseBatchDestroy`	Deletes or updates multiple processed rows with a single Data Manipulation Language (DML) statement.
Service	`DelayCommit`	Indicates whether to delay the commit/destroy action until all rows picked up (across multiple `maxTransactionSize` units) have been processed.
Service	`PollForChildUpdates`	Indicates whether an update to a detail row must result in the master row and all its details being picked up for processing.
Service	`ShouldOrderRows`	For `SequencingPollingStrategy`, there may be cases in which you do not want to order the rows by the sequence value.
Service	`NumberOfThreads`	Indicates the number of transactional threads to be used by the database adapter.
Service	`FetchSize`	Indicates the JDBC level cursor fetch size.
Service	`MaxBatchWritingSize`	Indicates the JDBC level statements per batch statement.
Service	`DeleteFromCursor`	Indicates the JDBC delete level while iterating over the result set.
Service	`UseDirectSQL`	Enables performance optimization in certain cases.
Service	`ReturnSingleResultSet`	Reads from multiple joined tables in a single SQL `select` statement rather than many, and returns a single giant result set.
Service	`MaxTransactionSize`	The maximum number of rows to raise as part of one database transaction.
Service	`SequencingFileName`	For `FileSequencingPollingStrategy` only. The file contains a single value, the last read sequence value/updated time. Timestamps appear in ISO format.
Service	`SchemaValidation`	Validates the XML against the XML schema before raising it. This can only happen if the automatically generated file has been hand-edited (that is, to add restrictions). Invalid records are rejected.
Service	`EnableStreaming`	Allows LOBs and multirecord XML files to be streamed through SAX events, allowing only a small part of the payload to be kept in memory at a time.
Reference	`DescriptorName`	The key into the TopLink metadata indicating the root relational table. Note that you cannot edit this property in Oracle Enterprise Manager Fusion Middleware Control.
Reference	`OutputCompletedXml`	Indicates if this interaction execution have an output message that is the input message with primary keys set.
Reference	`MappingsMetaDataURL`	The path to the `toplink.xml` file that describes how a database schema has been mapped to an XML schema. Note that you cannot edit this property in Oracle Enterprise Manager Fusion Middleware Control.
Reference	`OXMappingsMetaDataURL`	In conjunction with `MappingsMetaDataURL`, the path to the TopLink metadata file that describes how a database schema has been mapped to a particular predefined XML schema. Note that you cannot edit this property in Oracle Enterprise Manager Fusion Middleware Control.
Reference	`GetActiveUnitOfWork`	Operations within the same JTA transaction use the same TopLink session and connection, and writes occur together on a JTA commit.
Reference	`DmlType`	Indicates the type of DML operation (merge, insert, update, delete, or write).
Reference	`OutputCompletedXml`	Does this interaction execute have an output message that is the input message with primary keys set? This is useful when assigning primary keys on an insert.
Reference	`OptimizeMerge`	Sets some properties to improve performance of the merge. For one, if multiple objects are merged, the read queries to check for the existence and loads database versions into memory. Comparisons are performed as a single query, using an `in()` clause on the primary key.
Reference	`DetectOmissions`	Indicates whether to differentiate between null and "not there" in the input XML. The difference between `<director />` (omission) and `<director xsi:nil=\"true\"/>` (null).
Reference	`MaxBatchWritingSize`	The JDBC level statements per batch statement.
Reference	`UseDirectSQL`	Enables performance optimization in certain cases.
Reference	`QueryName`	The key into the TopLink metadata indicating the named query to execute, with predefined `where` clause and parameters.
Reference	`IsQueryByExample`	The query is generated dynamically on each invoke, based on matching the example input XML record.
Reference	`ReturnSingleResultSet`	An advanced feature that influences how many total select statements TopLink uses when querying against multiple related tables (that is, master-detail). The safest setting is the default (one per table); setting it to `true` than attempts one total, by outer joining all related selects into a single result set.
Reference	`CursorWindowSize`	The number of records to return at a time when selecting a very large number of rows in a single query.
Reference	`EnableStreaming`	Allows LOBs and multirecord XMLs to be streamed through SAX events, allowing only a small part of the payload to be kept in memory at a time.
Reference	`SqlString`	The SQL to execute in the pure SQL interaction. Note that you cannot edit this property in Oracle Enterprise Manager Fusion Middleware Control.
Reference	`IsTransactional`	Indicates whether the pure SQL being executed is a write statement that must occur within transaction boundaries.
Reference	`QueryTimeout`	Indicates the JDBC level `queryTimeout` setting. Note that you cannot edit this property in Oracle Enterprise Manager Fusion Middleware Control.
Reference	`MaxRows`	Indicates the JDBC level `maxRows` setting. Note that you cannot edit this property in Oracle Enterprise Manager Fusion Middleware Control.
Reference	`SchemaName`	The schema of the stored procedure to execute.
Reference	`PackageName`	The package of the stored procedure to execute.
Reference	`ProcedureName`	The procedure of the stored procedure to execute.
Reference	`Overload`	Further identifies the stored procedure to execute (in case of overloading) by the expected number of parameters.
Reference	`QueryTimeout`	Indicates the JDBC level `queryTimeout` setting.

33.1.2.3 Oracle File Adapter

Table 33-5 Opens a new window describes the properties available for the Oracle File adapter.

Table 33-5 Oracle File Adapter Properties

Service, Reference, or Endpoint	Property Name	Description
Service	`PhysicalDirectory`	Specifies the physical directory for the file/FTP adapter.
Service	`UseHeaders`	Set to `true` if the file/FTP adapter must publish metadata (for example, the file name, directory name, last modified data, file size, and to exclude the payload). This is typically used in large payload scenarios where you want to use the inbound adapter as a notifier.
Service	`Recursive`	If set to `true`, the file/FTP adapter processes files recursively in subdirectories.
Service	`PhysicalArchiveDirectory`	Directory in which the inbound file/FTP adapter archives files after they have been processed successfully.
Service	`PhysicalErrorArchiveDirectory`	Indicates the directory where the inbound file/FTP adapter archives files in case of failures, such as translation errors, and errors during publishing.
Service	`DeleteFile`	If set to `true`, the file/FTP adapter deletes the file after it has been processed.
Service	`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 file/FTP adapter.
Service	`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 file/FTP adapter.
Service	`PollingFrequency`	This parameter specifies how often does the file/FTP adapter looks for files in the inbound directory. It is specified in seconds.
Service	`MinimumAge`	This parameter specifies the time interval after which to pick up a file for processing. For example, this enables a large file to be completely copied into the directory before it is retrieved for processing. The age is determined by the last modified time stamp. For example, if you know that it takes three to four minutes for a file to be written, set the minimum age of pollable files to five minutes. If a file is detected in the input directory and its modification time is less than `5` minutes older than the current time, the file is not retrieved because it is still potentially being written to.
Service	`PublishSize`	This parameter indicates that a file contains multiple messages and specifies how many messages to process simultaneously. For example, if a certain file has `11` records and this parameter is set to `2`, then the file is processed `2` records at a time and the final record is processed in the sixth iteration.
Service	`Lenient`	If set to `true`, then the file adapter does not complain if it does not have enough permission to read/write to the inbound directory. By default, this is set to `false`.
Service	`TriggerFilePhysicalDirectory`	The directory path where the file/FTP adapter looks for the trigger files.
Service	`TriggerFile`	The name of the trigger file that causes the inbound file/FTP adapter to be activated.
Service	`TriggerFileStrategy`	This parameter defines the strategy that the file/FTP adapter uses to look for the specified trigger file in the trigger file directory. The acceptable values are `EndpointActivation`, `EveryTime`, or `OnceOnly`.
Service	`MaxRaiseSize`	This parameter specifies the maximum number of files that the file/FTP 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, then the file/FTP adapter submits `100` files every minute.
Service	`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 change it, 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.
Service	`AsAttachment`	If set to `true`, it causes the inbound file to be published as an attachment.
Service	`CharacterSet`	Set it to the character set for the attachment. This parameter is not used internally by the file/FTP adapter and is meant for third party applications that process the attachments published by the file/FTP adapter.
Service	`Encoding`	Set it to the encoding for the attachment. This parameter is not used internally by the file/FTP adapter and is meant for third party applications that process the attachments published by the file/FTP adapter.
Service	`ContentType`	Set it to the `Mime-Type` for the attachment. This parameter is not used internally by the file/FTP adapter and is meant for third party applications that process the attachments published by the file/FTP adapter.
Service	`ListSorter`	Specifies the sorter that the file/FTP adapter uses to sort files in the inbound direction. You can set this parameter to `\"oracle.tip.adapter.file.inbound.listing.TimestampSorterAscending\"` or `\"oracle.tip.adapter.file.inbound.listing.TimestampSorterDescending\"`. You can also plug in your own sorter by writing a class that implements `\"java.util.Comparator\"`.
Service	`SingleThreadModel`	If the value is `true`, the file/FTP adapter poller processes files in the same thread; it does not use the global in-memory queue for processing.
Service	`ThreadCount`	If this parameter is available, the adapter creates its own processor threads rather than depending on the global thread pool processor threads (by default, four of them). This parameter partitions the in-memory queue and each composite application gets its own in-memory queue. If the `ThreadCount` is set to `\"0\"`, then it behaves in the same manner as the single thread model. If `ThreadCount` is set to `\"-1\"`, then it starts using the global thread pool. The maximum value for this property is `40`.
Service	`recoveryInterval`	Used by the inbound adapter to configure the recovery interval in case of errors. For example, if the physical directory is nonexistent, then the adapter uses this value to perform periodic sleep/wake ups to check if the physical directory has been created and is accessible.
Reference	`PhysicalDirectory`	Specifies the physical directory for the file/FTP adapter.
Reference	`NumberMessages`	Specifies the outbound file naming convention used.
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`	Indicates if an opaque schema is being used.
Reference	`FileNamingConvention`	This parameter is for the naming convention for 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 file/FTP 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 file/FTP adapter writes translated data to a staging file and afterward streams the staging file to the target file. If `\"false\"`, then the outbound file/FTP adapter does not use an intermediate staging file.
Reference	`ConcurrentThreshold`	The maximum number of translation activities that can be allowed to execute in parallel for a particular outbound scenario. The translation step during the outbound operation is CPU intensive and hence must to be guarded as it may cause starvation in other applications/threads. The maximum is `100` (same as the maximum for `dspMaxThreads` in BPEL).
Reference	`SequenceName`	Specifies the Oracle database sequence name to be used if you have already configured the outbound file/FTP 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.
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	`DeleteFile`	If set to `\"true\"`, the file/FTP adapter deletes the file after it has been processed.
Reference	`IgnoreZeroByteFile`	Set it to `true` if you do not want the file/FTP 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 file/FTP adapter.
Reference	`ExcludeFiles`	Includes 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 file/FTP adapter.
Reference	`Recursive`	If set to `true`, the file/FTP adapter processes files recursively in subdirectories.
Reference	`MaxRaiseSize`	This parameter specifies the maximum number of files that the file/FTP 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, then the file/FTP 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 so, 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.
Reference	`SourceFileName`	The source file for the file I/O operation.
Reference	`SourcePhysicalDirectory`	The source directory for the file I/O 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 I/O operation.
Reference	`TargetPhysicalDirectory`	Indicates the target directory for the file I/O 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 \"`COPY`\",\"`MOVE`\", or \"`DELETE`\".
Reference	`BatchSize`	Set it to the batch size for the batching transformation.
Reference	`ChunkSize`	Specifies the number of outbound messages.

33.1.2.4 Oracle FTP Adapter

Table 33-6 Opens a new window describes the properties available for the Oracle FTP adapter.

Table 33-6 Oracle FTP Adapter Properties

Service, Reference, or Endpoint	Property Name	Description
Service	`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).
Service	`PhysicalDirectory`	This parameter specifies the physical directory for the file/FTP adapter.
Service	`UseHeaders`	Set to `\"true\"` if the file/FTP adapter must publish metadata (for example, the file name, directory name, last modified data, file size, and to exclude the payload. This is typically used in large payload scenarios where you want to use the inbound adapter as a notifier.
Service	`FileType`	Set it to either `\"ascii\"` or `\"binary\"`, depending on the requirement.
Service	`Recursive`	If set to `\"true\"`, the file/FTP adapter processes files recursively in subdirectories.
Service	`PhysicalArchiveDirectory`	Directory in which the inbound file/FTP adapter archives files after they have been processed successfully.
Service	`PhysicalErrorArchiveDirectory`	Indicates the directory where the inbound file/FTP adapter archives files in case of failures, such as translation errors, and errors during publishing.
Service	`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.
Service	`UseNlst`	Set this parameter to `\"true\"` if you need the FTP adapter to use the `\"NLST\"` FTP command instead of the `\"LIST\"` that the adapter uses by default.
Service	`DeleteFile`	If set to `\"true\"`, the file/FTP adapter deletes the file after it has been processed.
Service	`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 file/FTP adapter.
Service	`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 file/FTP adapter.
Service	`PollingFrequency`	This parameter specifies how often the file/FTP adapter checks for files in the inbound directory. It is specified in seconds.
Service	`MinimumAge`	This parameter specifies the time interval after which to pick up a file for processing. For example, this enables a large file to be completely copied into the directory before it is retrieved for processing. The age is determined by the last modified time stamp. For example, if you know that it takes three to four minutes for a file to be written, set the minimum age of pollable files to five minutes. If a file is detected in the input directory and its modification time is less than `5` minutes older than the current time, the file is not retrieved because it is still potentially being written to.
Service	`PublishSize`	This parameter indicates that a file contains multiple messages and specifies how many messages should be processed simultaneously. For example, if a certain file has `11` records and this parameter is set to `2`, then the file is processed `2` records at a time and the final record is processed in the sixth iteration.
Service	`TriggerFilePhysicalDirectory`	The directory path in which the file/FTP adapter looks for the trigger files.
Service	`TriggerFile`	The name of the trigger file that causes the inbound file/FTP adapter to activate.
Service	`TriggerFileStrategy`	This parameter defines the strategy that the file/FTP adapter uses to look for the specified trigger file in the trigger file directory. The acceptable values are `EndpointActivation`, `EveryTime`, or `OnceOnly`.
Service	`MaxRaiseSize`	This parameter specifies the maximum number of files that the file/FTP 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, then the file/FTP adapter submits `100` files every minute.
Service	`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.
Service	`AsAttachment`	If set to `\"true\"`, it causes the inbound file to be published as an attachment.
Service	`CharacterSet`	Set it to the character set for the attachment. This parameter is not used internally by the file/FTP adapter and is meant for third party applications that process the attachments published by the file/FTP adapter.
Service	`Encoding`	Set it to the encoding for the attachment. This parameter is not used internally by the file/FTP adapter and is meant for third party applications that process the attachments published by the file/FTP adapter.
Service	`ContentType`	Set it to the `Mime-Type` for the attachment. This parameter is not used internally by the file/FTP adapter and is meant for third party applications that process the attachments published by the file/FTP adapter.
Service	`ListSorter`	Specifies the sorter that the file/FTP adapter uses to sort files in the inbound direction. You can set this parameter to \"`oracle.tip.adapter.file.inbound.listing.TimestampSorterAscending`\", or \"`oracle.tip.adapter.file.inbound.listing.TimestampSorterDescending`\". You can also plug in your own sorter by writing a class that implements `\`"`java.util.Comparator`\".
Service	`SingleThreadModel`	If the value is `true`, the file/FTP adapter poller processes files in the same thread; it does not use the global in-memory queue for processing.
Service	`ThreadCount`	If this parameter is available, the adapter creates its own processor threads rather than depending on the global thread pool processor threads (by default, `4` of them). In other words, this parameter partitions the in-memory queue and each composite application gets its own in-memory queue. If the `ThreadCount` is set to `\"0\"`, then it behaves in the same manner as the `SingleThreadModel`. If the `ThreadCount` is set to `\"-1\"`, then it starts using the global thread pool. The maximum value for this property is `40`.
Service	`recoveryInterval`	Used by the inbound adapter to configure the `recoveryInterval` in case of errors. For example, if the `PhysicalDirectory` is nonexistent, then the adapter uses this value to perform periodic sleep/wake ups to check if the `PhysicalDirectory` has been created and is accessible.
Service	j`ca.message.encoding`	This parameter is used to override the encoding specified in the NXSD schema for the inbound file/FTP adapter.
Service	`oracle.tip.adapter. file.`debatching. `rejection.quantum`	This property lets you control the size of a rejected message for the inbound file/FTP adapter partner link. For example, if you set it to `\"100\"`, it causes the file/FTP adapter to reject `100` lines from the file since the actual file is too large.
Service	`useFileSystem`	This parameter is used by the inbound file/FTP adapter during read-only polling in a clustered environment. Setting it to `\"true\"` causes the adapter to use the file system to store metadata about files that have been already processed. Setting it to `\"false\"` causes the adapter to use a database table.
Service	`oracle.tip.adapter. file.timeout.recover picked.minutes`	Used by the inbound high-availability adapter when using `\"FILEADAPTER_IN\"` as the coordinator. When a file is first claimed (enqueued) by a node for processing, the `FILE_PROCESSED` column in `FILEADAPTER_IN` is set to `\"0\"`. At a later point in time, when one of the decoupled processor threads picks up the file for processing, the value of `FILE_PROCESSED` column is updated from `\"0\"` to `\"1\"`. When the file is processed completely, the `FILE_PROCESSED` column is updated from `\"1\"` to `\"2\"`. However, if the processor thread picks up a file, but the node crashes before it can process the file, then the file is never processed. This parameter is used to `\"undo\"` the pick operation. The adapter does this by deleting the entries in the `FILEADAPTER_IN` table that have been picked up, but not processed within the value specified here.
Service	`oracle.tip.adapter. file.timeout. recoverunpicked.minutes`	Used by the inbound high-availability adapter when using `\"FILEADAPTER_IN\"` as the coordinator. When a file is first claimed by a node for processing, the `FILE_PROCESSED` column in `FILEADAPTER_IN` is set to `\"0\"`. At a later point in time, when the decoupled-processor thread picks up the file for processing, the value of the `FILE_PROCESSED` column is updated from `\"0\"` to `\"1\"`. When the file is processed completely, the `FILE_PROCESSED` column is updated from `\"1\"` to `\"2\"`. If the node crashes when the `FILE_PROCESSED` is still `\"0\"`, the file is enqueued by a node (this means no other nodes can pick this one up). However, it also means that the decoupled processor threads have still not picked this one for processing. This parameter is used to `\"undo\"` the `claim(enqueue_` operation. The adapter does this by deleting the entries in the `FILEADAPTER_IN` table that have been claimed (for example, `FILE_PROCESSED ==\"0\"`), but not picked up until now.
Service	`purgeIntervalMillis`	Defines how often the poller thread purges control files for read-only polling scenarios. This defaults to `5` days.
Service	`oracle.tip.adapter.file. highavailability. maxRetryInterval`	The number of milliseconds after which the inbound file/FTP adapter retries to establish a database connection in distributed polling scenarios.
Service	`oracle.tip.adapter.file. highavailability.maxRetry`	The number of times that the inbound file/FTP adapter retries to establish a database connection in distributed polling scenarios.
Service	`oracle.tip.adapter. file.rejectOriginalContent`	Setting to `\"true\"` causes the file/FTP adapter to reject the original actual content. If set to `\"false\"`, the adapter rejects the XML data created because of the translation step.
Service	`notifyEachBatchFailure`	Setting to `\"true\"` causes the file/FTP adapter to call the notification agent's `onBatchFailure` every time an error occurs in a debatching scenario. If set to `\"false\"`, the file/FTP adapter calls `onBatchFailure` only once after all messages in the debatching scenario.
Reference	`PhysicalDirectory`	The directory path for the file/FTP 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 file/FTP 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 file/FTP adapter writes translated data to a staging file and afterward streams the staging file to the target file. If `\"false\"`, then the outbound file/FTP 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 applications/threads. 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 file/FTP 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.
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 file/FTP adapter deletes the file after it has been processed.
Reference	`IgnoreZeroByteFile`	Set it to `\"true\"` if you do not want the file/FTP 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 file/FTP 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 file/FTP adapter.
Reference	`Recursive`	If set to `\"true\"`, the file/FTP adapter processes files recursively in subdirectories.
Reference	`MaxRaiseSize`	This parameter specifies the maximum number of files that the file/FTP 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 file/FTP 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.
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 I/O operation.
Reference	`SourcePhysicalDirectory`	Indicates the source directory for the file I/O 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 I/O operation.
Reference	`TargetPhysicalDirectory`	The target directory for the file I/O 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 I/O operation is a local file system as opposed to a remote FTP server.
Reference	`TargetIsRemote`	Set it to `\"false\"` to I/O notify the FTP adapter that the target for the I/O 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.

33.1.2.5 Oracle JMS Adapter

Table 33-7 Opens a new window describes the properties available for the Oracle JMS adapter.

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.
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.

33.1.2.6 Oracle MQ Series Adapter

Table 33-8 Opens a new window describes the properties available for the Oracle MQ Series adapter.

Table 33-8 Oracle MQ Series Adapter Properties

Service, Reference, or Endpoint	Property Name	Description
Service	`MessageType`	Indicates the message type of the outbound/dequeue message.
Service	`QueueName`	Indicates the name of the inbound/outbound queue.
Service	`UseMessageEncodingForTranslation`	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	`UseMessageEncodingForTranslation`	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	`FallbackReplyToQueueManagerName`	Indicates the `Fallback` Reply To queue manager name.
Service	`Priority`	Indicates the priority of the reply/outbound message.
Service	`Expiry`	Indicates the expiry time for the reply/outbound message.
Service	`Persistence`	Indicates the persistence of the reply/outbound message.
Service	`Feedback`	Indicates the feedback code of the reply/outbound message. Note that you cannot edit this property in Oracle Enterprise Manager Fusion Middleware Control.
Service	`MessageFormat`	Indicates the format of the reply/outbound message.
Service	`OnDeliveryFailure`	Indicates the behavior of the adapter if reply/outbound 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 inbound/outbound 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 inbound/outbound 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 reply/outbound 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.
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	`FallbackReplyToQueueManagerName`	Indicates the `Fallback` `Reply` `To` queue manager name.
Reference	`Priority`	Indicates the priority of the reply/outbound message.
Reference	`Expiry`	Indicates the expiry time for the reply/outbound message.
Reference	`Persistence`	Indicates the persistence of the reply/outbound message.
Reference	`Feedback`	Indicates the feedback code of the reply/outbound 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 reply/outbound 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 reply/report message in a asynchronous request-response scenario has an opaque schema.
Reference	`ResponseWaitInterval`	Indicates the wait time for the reply/report to arrive.
Reference	`ResponseNoMessageAllowed`	Set to `true` if no message is allowed as a reply/report after the specified wait interval.
Reference	`ResponseGetMessageOptions`	Indicates the `Get` message options for a reply/report.
Reference	`ResponseQueueOpenOptions`	Indicates the open options for a reply/report 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	`UseMessageEncodingForTranslation`	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	`UseMessageEncodingForTranslation`	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.

33.1.2.7 Oracle Socket Adapter

Table 33-9 Opens a new window describes the properties available for the Oracle Socket Adapter.

Note:

Properties such as TransMode and XSLT, which are not listed in Table 33-9 Opens a new window

, are displayed in the Properties tab. However, you cannot edit properties that are not listed in Table 33-9 Opens a new window

. Making changes to noneditable properties makes the composite invalid and requires remodeling of 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.1.2.8 Oracle JCA Adapters Endpoint Properties

Table 33-10 Opens a new window 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-10 Oracle JCA Adapters Endpoint Properties

Direction (Inbound/Outbound)	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	`rejectUncorrelatedMessages`	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.

The following examples show how to specify the endpoint properties in the composite.xml file in Oracle JDeveloper:

Example 1: Specifying Endpoint Properties - Inbound
Example 2: Specifying Endpoint Properties - Outbound

Example 1: Specifying Endpoint Properties - Inbound

<service name="Inbound">
  <interface.wsdl interface="http://xmlns...#wsdl.interface(Inbound_PortType)"/>
  <binding.jca config="Inbound_db.jca">
    <property name="jca.retry.interval">5</property>
    <property name="jca.retry.interval">1</property>
    <property name="jca.retry.backoff">2</property>
    <property name="jca.retry.maxInterval">6</property>
  </binding.jca>
</service>

Notice that the inbound property jca.retry.maxPeriod is not supported (like it is in the outbound direction).

Example 2: Specifying Endpoint Properties - Outbound

<reference name="Outbound">
  <interface.wsdl interface="http://xmlns...#wsdl.interface(Outbound_PortType)"/>
  <binding.jca config="Outbound_jms.jca">
    <property name="jca.retry.count">5</property>
    <property name="jca.retry.interval">1</property>
    <property name="jca.retry.backoff">2</property>
    <property name="jca.retry.maxInterval">6</property>
    <property name="jca.retry.maxPeriod">30</property>
  </binding.jca>
</reference>

33.1.3 Changing the Endpoint Reference and Service Key for Oracle Service Registry Integration

If a reference binding component of the SOA composite application is integrated with Oracle Service Registry (OSR), you can change the endpoint reference and service key in the General section of this page.

The UDDI ServiceKey field automatically displays the value of binding.ws property="oracle.soa.uddi.serviceKey" from the composite.xml file if you selected to use UDDI for runtime resolution of the endpoint.

You can edit the UDDI ServiceKey field after the SOA composite application has been deployed to either:

Change the value as needed.
Add it to a composite that did not use UDDI for runtime endpoint resolution.

The Endpoint Address field represents the endpoint location as defined with the ws.binding endpointURI property in the composite.xml file. The Endpoint Address field is not filled in after the SOA composite application has been deployed, but can override the endpoint location in the concrete WSDL.

The endpoint location order of precedence is as follows:

Dynamically set the binding oracle.soa.uddi.serviceKey at runtime in the UDDI ServiceKey field.
Dynamically set the binding property endpointURI at runtime in the Endpoint Address field.
Use the binding property value for oracle.soa.uddi.serviceKey in the composite.xml file (viewable and editable in Oracle Enterprise Manager Fusion Middleware Control).
Use the binding property value for endpointURI in the composite.xml file (viewable and editable in Oracle Enterprise Manager Fusion Middleware Control).
Use the location specified in the concrete WSDL.

Figure 33-1 Opens a new window provides shows both fields.

Figure 33-1 Endpoint Reference and Service Key Properties

Description of "Figure 33-1 Endpoint Reference and Service Key Properties" Opens a new window

In the UDDI ServiceKey field, change the service key to use during runtime.
In the Endpoint Address field, enter the endpoint address to use during runtime.

You can edit both fields. The value for one field is selected and used based on what you selected in the UDDI Deployment Options dialog during design time. The changes to these fields are persisted in the composite.xml file during runtime.

For information about design-time tasks such as how to publish a business service, create a connection to the UDDI registry, and configure a SOA project to invoke a service from the registry, see Oracle Fusion Middleware Developer's Guide for Oracle SOA Suite.

For information about how to set the inquiry URL during runtime, see Section 3.1, "Configuring SOA Infrastructure Properties." Opens a new window

33.1.3.1 Configuring Caching of WSDL URLs

Caching of endpoint WSDL URLs occurs by default during runtime. If an endpoint WSDL URL is resolved using the orauddi protocol, subsequent invocations retrieve the WSDL URLs from cache, and not from OSR. You can increase the amount of time that the endpoint WSDL URL is available in cache for inquiry by the service key with the UddiCacheLifetime property. This property invalidates the cache at specified time intervals. The default value is 86400 seconds. The minimum value is 300 seconds.

To configure endpoint caching of WSDL URLs:

From the SOA Infrastructure menu, select Administration > System MBean Browser.
Select Application Defined MBeans > oracle.as.soainfra.config > Server: soa_server1 > SoaInfraConfig > soa-infra > Attributes.
Click the UddiCacheLifetime property on the right side of the page.
Enter a value.
Click Apply.

Page 50 of 61