26 Monitoring Oracle JCA Adapters

Learn how to monitor inbound and outbound Oracle JCA adapters, including monitoring instances and faults, recent faults and rejected messages, adapter properties, and adapter logs.

26.1 Monitoring Instances and Faults for an Inbound Adapter

An invocation to a service from a composite may result in an error. This error is captured as a fault in the service. You can view the details of the instances and faults of the inbound adapter in the Instances and Faults section of the Dashboard page.

To monitor instances and faults for an inbound adapter:

Navigate to the SOA composite application by using either of the following options:

From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...
Click Home. The SOA Infrastructure page is displayed. Click the Deployed Composites tab. The list of deployed composites is displayed. In the Composite section, click a specific SOA composite application. The SOA Composite home page is displayed. Click the inbound adapter (service) from the Services and References section in the right panel. The Service Home page is displayed.	Under soa-infra, click a specific SOA composite application. The SOA Composite Home page is displayed. Click the inbound adapter (Service) from the Services and References section in the right panel.

Monitor the instances and faults for an inbound adapter:
1. The Dashboard page is, by default, selected once you select the composite under soa-infra.
2. Select the Flow instance tab. Under that the Instances with Faults Section is displayed. You can view the instances and faults within the Instances and Faults section.
  
  The details of the fault is displayed in a line chart in the Instances and Faults section, which you can search within to find recent faults. This line chart shows the total number of outgoing messages since the start of the server, and the total number of faults since the start of the server.

For more information about monitoring adapters, see Understanding Technology Adapters.

26.2 Monitoring Recent Faults and Rejected Messages for an Inbound Adapter

You can view the details of the recent faults and rejected messages of the inbound adapter under the Flow Instances tab of the Dashboard page.

To monitor the recent rejected messages for an inbound adapter:

Navigate to the SOA composite application by using either of the following options:

From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...
Click Home. The SOA Infrastructure page is displayed. Click the Deployed Composites tab. The list of deployed composites is displayed. In the Composite section, click a specific SOA composite application. The SOA Composite home page is displayed. Click the inbound adapter (Service) from the Services and References section in the right panel. The Service Home page is displayed.	Under soa-infra, click a specific SOA composite application. The SOA Composite home page is displayed. Click the inbound adapter (service) from the Services and References section in the right panel. The Service Home page is displayed.

Monitor the recent faults and rejected messages for an inbound adapter:
1. Click Dashboard.
  
  The Dashboard page is displayed.
2. View the recent faults and rejected messages listed in Instances and Faults section within the Flow Instances tab.
  
  A list of recently rejected faults and messages with details such as error message, fault time, and the business flow instance ID is displayed.
  
  For more information about monitoring adapters, see Understanding Technology Adapters.

26.3 Monitoring Faults for an Inbound Adapter

You can view the details of the faults and rejected messages of an inbound adapter in the Flow Instances page.

To monitor the rejected messages for an inbound adapter:

Navigate to the SOA composite application by using either of the following options:

From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...
Click Home. The SOA Infrastructure page is displayed. Click the Deployed Composites tab. The list of deployed composites is displayed. In the Composite section, click a specific SOA composite application. The SOA Composite Home page is displayed.	Under soa-infra, click a specific SOA composite application. The SOA Composite Home page is displayed.

To monitor the faults and rejected messages for an inbound adapter:
1. View the recent faults and rejected messages listed in Instances and Faults section within the Flow Instances tab.
  
  A list of faults and rejected messages with details such as error message, fault time, and business flow instance ID is displayed.

For more information about monitoring adapters, see Understanding Technology Adapters.

26.3.1 Searching for Rejected Messages for an Inbound Adapter

Use the Search feature to search for faults and rejected messages for an inbound adapter.

To search for faults and rejected messages for an inbound adapter:

Navigate to the SOA composite application by using either of the following options:

From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...
Click Home. The SOA Infrastructure page is displayed. Click the Deployed Composites tab. The list of deployed composite applications is displayed. In the Composite section, click a specific SOA composite application. The SOA Composite Home page is displayed.	Under soa-infra, click a specific SOA composite application. The SOA Composite Home page is displayed.

Select the Flow instance tab to obtain the Instances with Faults section.
Enter any or all of the following search options:
- Instances within a Time Range
  
  Enter any part of the error message text.
- Time
  
  Enter the ID of the fault.
- Composite
  
  Select Initiating or Participating from the toggle.
- State
  
  Select Active, which can be one of All Active, Recovery, Running, Suspended, or Inactive, which can be one of All Inactive, Completed, Failed or Aborted
- Fault
  
  Select a type from the list of faults available. These include: All Faults, Recovery Required, Nonrecoverable, Recovered, System Auto Retries
- You can also choose to search for only Recent Instances, Instances with Faults, Recoverable Instances.
Click Search to start the search operation.

The fault or rejected message matching the criteria you specified is displayed.
Click Reset to reset the search criteria.

For more information about configuring adapters, see Understanding Technology Adapters.

26.3.2 Deleting Rejected Messages for an Inbound Adapter

You can directly delete rejected messages from the database by specifying a search criteria.

To delete rejected messages for an inbound adapter:

Navigate to the SOA composite application by using either of the following options:

From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...
Click Home. The SOA Infrastructure page is displayed. Click the Deployed Composites tab. The list of deployed composite applications is displayed. In the Composite section, click a specific SOA composite application. The SOA Composite home page is displayed.	Under soa-infra, click a specific SOA composite application. The SOA Composite home page is displayed.

Select the Flow instance tab to obtain the Instances with Faults section.
Click the Delete Selected Flow Instances icon

The Delete Selected Flow Instances dialog is displayed.
Click Delete.

To delete a fault, you must delete the associated business flow instance from the Instances page.

For more information about configuring adapters, see Understanding Technology Adapters.

26.4 Monitoring Properties for an Inbound Adapter

You can view the details of the properties of an inbound adapter in the Properties page.

To monitor the properties for an inbound adapter:

Navigate to the SOA composite application by using either of the following options:

From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...
Click Home. The SOA Infrastructure page is displayed. Click the Deployed Composites tab. The list of deployed composites is displayed. In the Composite section, click a specific SOA composite application. The SOA Composite home page is displayed. Click the inbound adapter (service) from the Services and References section in the right panel. The Service Home page is displayed.	Under soa-infra, click a specific SOA composite application. The SOA Composite home page is displayed. Click the inbound adapter (service) from the Services and References section in the right panel. The Service Home page is displayed.

Monitor the properties for an inbound adapter:
1. Click Properties.
  
  The Properties page is displayed for that adapter.
  
  A list of properties with details such as name and value is displayed.

Note:

For any adapter that has an inbound asynchronous request-reply scenario (the Get Message operation preceding the Send Reply operation), only details about the activation specification are displayed; details about the interaction specification are not displayed.

For more information about monitoring adapters, see Understanding Technology Adapters.

26.5 Monitoring Instances and Faults for an Outbound Adapter

An invocation to a reference from a composite may result in an error. This error is captured as a fault in the reference. The details of the instances and faults of the outbound adapter can be viewed in the Instances and Faults section of the Dashboard page.

To monitor instances and faults for an outbound adapter:

Navigate to the SOA composite application by using either of the following options:

From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...
Click Home. The SOA Infrastructure page is displayed. Click the Deployed Composites tab. The list of deployed composites is displayed. In the Composite section, click a specific SOA composite application. The SOA Composite home page is displayed. Click the outbound adapter (reference) from the Services and References section in the right panel. The Service Home page is displayed.	Under soa-infra, click a specific SOA composite application. The SOA Composite home page is displayed. Click the outbound adapter (reference) from the Services and References section in the right panel. The Service Home page is displayed.

Monitor the instances and faults for an outbound adapter:
1. Click Dashboard.
  
  The Dashboard page is displayed.
2. View the instances and faults listed in the Instances and Faults section, after clicking on the Flow Instances tab.
  
  The details of the fault is displayed in a line chart in the Instances and Faults section. This line chart shows the total number of outgoing messages since the start of the server, and the total number of faults since the start of the server.
3. Select Table View to see an expanded table view listing to see total number of messages since server start or total number of faults since server start, which you can sort by ascending, or descending order, or you can sort by more advanced criteria by choosing advanced.

For more information about monitoring adapters, see Understanding Technology Adapters.

26.6 Monitoring Faults for an Outbound Adapter

The details of the instances and faults of the outbound adapter can be viewed in the Faults page.

To monitor faults for an outbound adapter:

Navigate to the SOA composite application by using either of the following options:

From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...
Click Home. The SOA Infrastructure page is displayed. Click the Deployed Composites tab. The list of deployed composites is displayed. In the Composite section, click a specific SOA composite application. The SOA Composite Home page is displayed.	Under soa-infra, click a specific SOA composite application. The SOA Composite Home page is displayed.

To monitor the faults for an outbound adapter:
1. Select the Flow instance tab to obtain the Instances with Faults section.
2. Select Table View to see a listing of faults, total number of incoming messages since server start and total number of faults., and to sort the displayed data according to your preference.

For more information about monitoring adapters, see Understanding Technology Adapters.

26.6.1 Searching for Faults for an Outbound Adapter

Use the Search feature to search for faults for an outbound adapter.

To search for faults for an outbound adapter:

Navigate to the SOA composite application by using either of the following options:

From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...
Click Home. The SOA Infrastructure page is displayed. Click the Deployed Composites tab. The list of deployed composite applications is displayed. In the Composite section, click a specific SOA composite application. The SOA Composite Home page is displayed.	Under soa-infra, click a specific SOA composite application. The SOA Composite Home page is displayed.

Select the Flow instance tab to obtain the Instances with Faults section.
Click the Search icon at the right to execute any saved Searches.
In the Search Options section, enter any or all of the following search criteria:
- Select the Reset icon to reset the search criteria.
- Select the Disk icon to save the custom search.
- Select the Bookmark icon to generate a bookmarkable link.
- Select the Funnel icon on the right to customize (that is, add or remove) filters.
- On the Add/Remove Filters link t you can set Filters by you can add or remove Filters by Time, Composite, Resequencer, Flow Instance, State, Fault, or User.
- Using Search Options, you can set Recent Instances, Instances with Faults, Recoverable Instances, All Saved Searches.
- You can either select Customize Time Period, or Last number of hours, minutes, days or weeks.
- Choose Participating or a Composite.
- Choose State, which can be All Active, Recovery, Suspended, Running.
- Chose Fault, which can be any one of All Faults, Recovery Required, Nonrecoverable, Recovered, System Auto Retries.
Click Search to start the search operation.

The fault matching the criteria you specified is displayed.

For more information about configuring adapters, see Understanding Technology Adapters.

26.7 Monitoring Properties for an Outbound Adapter

The details of the properties of the outbound adapter can be viewed on the Properties page.

To monitor properties for an outbound adapter:

Navigate to the SOA composite application by using either of the following options:

From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...
Click Home. The SOA Infrastructure page is displayed. Click the Deployed Composites tab. The list of deployed composites is displayed. In the Composite section, click a specific SOA composite application. The SOA Composite home page is displayed. Click the outbound adapter (reference) from the Services and References section in the right panel. The Service Home page is displayed.	Under soa-infra, click a specific SOA composite application. The SOA Composite home page is displayed. Click the outbound adapter (reference) from the Services and References section in the right panel. The Service Home page is displayed.

Monitor the properties for an outbound adapter:
1. Click the Properties tab.
  
  The Properties page is displayed.
2. Click View.
  
  A list of properties with details such as name and value is displayed.

Note:

Where an adapter has an outbound asynchronous request-reply scenario (the Send Message operation preceding the Get Response operation), only details about the interaction specification are displayed, and details about the activation specification are not displayed.

For more information about monitoring adapters, see Understanding Technology Adapters.

26.8 Monitoring Adapter Logs

Oracle Fusion Middleware components generate log files containing messages that record all types of events, including startup and shutdown information, errors, warning messages, access information on HTTP requests, and additional information. There is only one logger for all Oracle JCA Adapters, and the logger is called oracle.soa.adapter.

To monitor the File adapter logs:

Navigate to your SOA composite dashboard for the selected composite application.
Select the logs for your composite application from the Selected Links link to the right of the SOA composite dashboard.
Supply a date and time range for the logs you want to examine.
In addition to date and time range, you can also provide other criteria to delimit the list of logs you will find. These include the following:
- Message contains | is | is not | does not contain | starts with | does not start with | ends with | does not end with | matches | does not match
- Composite name is | is not | contains | does not contain | starts with | does not start with | ends with | does not end with | matches | does not match
- Fault id is | is not |contains | does not contain | starts with | does not start with | ends with | does not end with | matches | does not match
- Flow correlation is | is not |contains | does not contain | starts with | does not start with | ends with | does not end with | matches | does not match
- Flow id is | is not |contains | does not contain | starts with | does not start with | ends with | does not end with | matches | does not match
Oracle Enterprise Manager Fusion Middleware Control displays a list of logs meeting the criteria you have supplied. Select a server log from the list of logs and download to view it in an editor.
You could have alternatively navigated from Target-Navigation-Domain and right-clicked on the domain where the composite resides to select View Log Messages. This brings up a list of log messages directly.
Information about SOA adapter logs can be found in the logger.

For information about configuring logs, see Configuring Log Files. For information about diagnostics related to logs, see Diagnosing Problems with SOA Composite Applications.

26.9 Adapter Configuration Reports

Oracle Adapter Configuration reports provide information on how you have configured Adapters. They provide diagnostics information in addition to Snapshot reports and Monitoring reports. Without this the support, one has to go through multiple consoles and logs for diagnosis. There are many more Adapter properties than those reported on in the diagnostic reports; however, the reports provide information from the most relevant properties.

The configuration report provides information on the service endpoints; each of these reports correlate and provide you with information that would otherwise require you to do a large amount of moving between different reports to find information related to Adapter configuration.

Adapter Configuration reports capture:

Connection Factory properties
Service Definition Properties (Activation Properties and other specs related to a service endpoint).
Service Tuning Properties - Service endpoint properties used to tune the service to alter performance items such as throughput and throttling.
Reference Definition Properties (Interaction Properties and other types of specs involved in Reference endpoint).
Reference Tuning Properties - Reference endpoint properties used to tune the service to alter performance factor such as throughput and throttling.

The Reports do not provide information on Adapter-specific properties that are not part of Connection Factory properties. For example, the reports do not provide information on LDAP RootDSE properties.

26.9.1 Enabling Display of Adapter Reports

You can enable the following Adapter reports to display in Oracle Enterprise Manager Fusion Middleware Control:

You can enable reports by checking the box at the top of the Monitoring Reports page. Another way to enable reports to add corresponding property on the Properties tab.

26.9.1.1 Monitoring Report

Within a Monitoring report, showing real-time monitoring statistics, the activation spec provides configuration-related information, including:

EIS connection configurations, displayed as connection factory properties.
Resources that are being accessed. These include Managed Connections and the Most Recent Timestamp for such connections.
Additional tuning information, such as Currently Free Connections and Maximum Pool Size for Connections.

Figure 26-1 shows the appearance of the Monitoring report in the context of the Diagnosability and Snapshot reports. This report shows a information related to a service endpoint.

Figure 26-1 Monitoring Report Showing Statistics for a Service Endpoint

Description of "Figure 26-1 Monitoring Report Showing Statistics for a Service Endpoint"

See Figure 26-1 for a description of the elements in the Monitoring Report.

Table 26-1 Adapter Monitoring Report Elements

Element	Description
Server Name	The name of the server where the endpoint is deployed.
EIS Connection Status	Indicates if the EIS is connected to the Endpoint. You can click status icon to obtain stack trace if status is Not connected.
Managed Connections	Connection pool statistics for the managed connections for this Adapter to Enterprise Information System (EIS) systems.
Currently Free	The pool size of this Connector connection pool.
Average Number Used	The running average usage of created connections that are active in the Connector Pool since the pool was last shrunk.
Currently Free	The current total free connections.
Maximum Pool Size	The maximum capacity configured for this Connector connection pool.
Most Recent Time Stamp	The most recent time stamp for last message publication and last service activation.
Last Message Publication	Last message published to the fabric for a service endpoint; last message published to the EIS for a reference endpoint.
Last Service Activation	Last time the service endpoint was activated. Only for a service endpoint.
Last Reference Interaction	Last time the reference endpoint was activated. Only for a reference endpoint.

26.9.1.2 Configuration Reports

The Configuration report within the Diagnosability Report from the Oracle Enterprise Manager Fusion Middleware Control dashboard shows a summary of connection factory, binding and activation properties for a specific service endpoint.

Figure 26-2 shows an Adapter Configuration Report for a Service Endpoint, showing Deployment Configuration Type, and information about EIS Connectivity and Service Properties, including definition properties and Tuning Properties, in this case properties that are specific to a File Adapter.

Figure 26-2 Adapter Configuration Reports

Description of "Figure 26-2 Adapter Configuration Reports"

See Table 26-2 for a description of the elements in the Adapter Configuration Report.

Note that you need to select Related Links (at the top right of the page) to initiate the process of configuring a connection factory within the WebLogic Server Console.

Table 26-2 Adapter Configuration Reports Elements

Element	Description
Deployment Configuration Type	Indicates if the endpoint is part of an active-active or active-passive configuration. This is only displayed for a service endpoint.
EIS Connectivity	Provides information about connection factory properties related to this endpoint and its connection to the Enterprise Information System.
Service Properties	Lists Definition Properties, used to define services specific to this endpoint, and Tuning Properties, used to tune services specific to this endpoint. For Reference Endpoints, there are Reference Properties which include Definition Properties and Tuning Properties. See the User's Guide to Technology Adapters appendix for the complete list and definitions of the properties.

Element

Description

Deployment Configuration Type

Indicates if the endpoint is part of an active-active or active-passive configuration. This is only displayed for a service endpoint.

EIS Connectivity

Provides information about connection factory properties related to this endpoint and its connection to the Enterprise Information System.

Service Properties

Lists Definition Properties, used to define services specific to this endpoint, and Tuning Properties, used to tune services specific to this endpoint. For Reference Endpoints, there are Reference Properties which include Definition Properties and Tuning Properties.

See the User's Guide to Technology Adapters appendix for the complete list and definitions of the properties.

26.9.1.3 Snapshot Reports

The Snapshot Reports section of the Service or Reference Adapter Reports Page provides connection downtime and message statistics over a specified period.

Snapshot reports aggregate historical data over a selected period of time.

The default for snapshot data persistence is 15 minutes, which is the period of time collection over which the captured data persists when Write to database is checked. You can configure the snapshot interval from the snapshotInterval property in the Properties tab. Because the default value of some properties on the Properties tab is not shown explicitly, you might need to add snapshotInterval property from the properties page and then modify it as you require. You can select Write to Database on a Report Screen to have the data persisted.

Similarly, you can add or modify enableSnapshots (enables Write to Database) and select the Enables Reports checkbox (enables Reports).

Note that you must understand each Snapshot report in the context of the functioning of the specific adapter; for example, for the Database Adapter, the payload size that is reported and displayed is the size of XML produced by the Adapter, never the size of XML consumed by the Adapter.

Where an adapter has no output, the size is reported as 0.

For the same service endpoint, you can correlate information from the Snapshot report and the Monitoring Report.

Figure 26-3 shows an example Snapshot Report, with the Message Statistics tab selected. The Report shows:

Data will be retrieved over the last 24 hours
The name of the server for which information is being collected
Average Message Size, in bytes
Maximum Message Size, in bytes
Minimum Message Size, in bytes
Total Message Size, in bytes
Number of Messages
Data Location, specifying Persisted or In-Memory, as indicated by an icon and tooltip
Write to Database-enables data persistence. By default, the data is not persisted. Note that when enabled, persistence is enabled concurrently for both EIS Connection statistics and Message statistics at once. Once you enable persistence, the value for writes to the database is displayed (for example, "every 15 minutes".)

Figure 26-3 Snapshot Report, with Message Statistics Tab Selected

Description of "Figure 26-3 Snapshot Report, with Message Statistics Tab Selected"

Figure 26-4 shows an example Snapshot Report, with EIS Connection Downtime, or the down shown. The Report shows:

Server Name
The Start EIS Downtime-when the connection downtime began
The End EIS Downtime-when the connection downtime ended
Error Summary-A summary of the errors that might be related to the downtime.
Total EIS Connection Downtime.
Data Location, specifying Persisted or In-Memory, as indicated by an icon and tooltip
Show XML button, which when clicked on provides XML data for the information that is displayed.

Figure 26-4 Snapshot Report with EIS Connection Downtime Tab Selected

Description of "Figure 26-4 Snapshot Report with EIS Connection Downtime Tab Selected "

26.9.1.3.1 Snapshot Reporting Persistence and Intervals

The snapshot persistence period can provide historical data over the period the data is persisted; this period is different than the global refresh period for the Oracle Enterprise Manager Fusion Middleware Control.

You must also distinguish the Snapshot Interval (default is 15 minutes) versus the Retrieve Data period, which is defaulted to one day.

Persisted and In-memory data is shown per query criteria (that is, EIS connection downtime falls within the time range used for searching or message publication time is within the time range used for searching).

The persistence setting provides a way to guard saved data from crashes and downtime. However, there is a performance cost to retaining saved data.

A Data Location column in the reports contains either or both of two icons which signify the place of origin of the data in the reports in the appropriate row: either from persistent data or from in-memory data.

Also note that data is not persisted in the following circumstances.

For non-persisted (in-memory) data, when the following occur:

Write to database is unchecked
The adapter's composite application is shutdown or retired
Composite is un-deployed
The Adapter endpoint is de-activated (for service endpoints)
The SOA server is bounced
Auto purge occurred

For persisted data, data is not persisted when the following occur:

Auto purge occurred

You can search and retrieve past data. Therefore, the Retrieve Data search control is always available for data that persists. The search feature is specific to Enterprise Information System (EIS) Connection statistics and is distinct from Message statistics.

Table 26-3 provides information about the different elements found in the Snapshot Adapter Reports and their meaning.

Table 26-3 Snapshot Adapter Report Elements

Element	Description
EIS Connection Downtime	(Only shown for the service downtime.)
Select a Time Range	The time range filter delimits the statistics displayed in the snapshot reports to a specified number of minutes, hours, days, or weeks.
Show XML	Shows the EIS connection downtime in an XML format.
Server Name	The name of the server connected to this Adapter for which messages are being displayed.
End EIS Connection Downtime	Time at which the EIS connection is restored.
Start EIS Downtime	The time at which the EIS connection is lost.
Error Summary	Select Error Summary to provide stack trace.
Message statistics
Server Name	The name of the server where this endpoint is displayed.
Average Message Size	Average message size processed for the filtered snapshot interval.
Maximum Message Size	Maximum message size processed for the filtered snapshot interval.
Minimum Message Size	Minimum message size processed for the filtered snapshot interval.
Total Message Size (Bytes)	Sum total of all the messages processed for the filtered snapshot interval.
Number of Messages	Number of messages processed for the filtered snapshot interval.
Data Location	Specifies Persisted or In-Memory, as indicated by an icon and tooltip.
Write to Database	Select this checkbox to enable persistence. The value (for example, every 15 minutes) shows how often that write to the database happens, when enabled. By default the check box is not selected. Persistence is enabled for both EIS Connection starts and Message statistics at the same time. The screen indicates the following: “Select to persist the data. Persisted data remains available in case of downtimes or crashes, or if you disable the reports; but it impacts performance. Persistence operations involve a snapshot scheduler and repetitive I/O (disk read and write) operations. Persistent operations are different from in-memory operations because I/O operations from memory are faster than Database operations.

26.9.2 Configuration Report Categories and Adapter Properties Reported

The following tables show, for each Adapter type, the configuration report category, the available property name, and a description of each property. Although adapter configuration properties can be set at service/reference Mbean and Adapter binding Mbean, the Adapter configuration report shows only properties from the Adapter binding Mbean.

Table 26-4 MSMQ Adapter Connection Factory Properties

Property Name	Description
QueueManagerName	MQ Series Queue Manager Name
PortNumber	Port on which the Queue Manager is listening
HostName	Host on which Queue Manager is running
ChannelName	MQ Series Server Connection Channel name
CCDTurl	The url to the MQ Series CCDT file.
XATransaction	Flag which enables participation in JTA transaction
SSLEnable	Flag which enables SSL.

Table 26-5 MSMQ Adapter Service Definition Properties

Property Name	Description
QueueName	Queue on which the MQSeries Adapter is polling.
BackoutQueueName	The configured Backout Queue Name (if any).
MessageSelector	MessageSelector to filter inbound messages.

Table 26-6 MSMQ Adapter Service Tuning Properties

Property Name	Description
jca.retry.count	JCA retry count before the message is rejected.
jca.retry.interval	Time interval between the JCA retries.
payloadSizeThreshold	Decides the size of the payload that the adapter can process.
InboundThreadCount	Number of inbound polling threads to dequeue messages

Table 26-7 MSMQ Adapter Reference Definition Properties

Property Name	Description
QueueName (Enqueue)	Queue to which messages are published
QueueName (Dequeue)	Queue from which messages are dequeued
SegmentIfRequired	Flag telling whether large message should be segmented.

Table 26-8 MSMQ Adapter Reference Tuning Properties

Property Name	Description
jca.retry.count	JCA retry count before the message is rejected
jca.retry.interval	Time interval between the JCA retries
payloadSizeThreshold	This value decides the size of the payload that the adapter can process.

Table 26-9 File Adapter Connection Factory Properties

Property Name	Description
ControlDir	The directory used by the Adapter for storing book-keeping information.
InboundDataSource	Set to the datasource name to enable High availability in the inbound adapter.
OutboundLockTypeForWrite	Set to either oracle, database or coherence to enable HA on the outbound adapter.
IsTransacted	Set to true for LRC (Last Resource Commit). This applies only if you choose LocalTransaction for the transaction-supports attribute

Table 26-10 File Adapter Service Definition Properties

Property Name	Description
PhysicalDirectory	Directory to be polled by the File Adapter.
Recursive	If set to true, the File/Ftp Adapter processes files recursively in sub-directories.
DeleteFile	If set to true, the File/Ftp Adapter deletes the file after it has been processed.
PollingFrequency	This parameter specifies how often does the File/Ftp Adapter wake up in order to look for files in the inbound directory. It is specified in seconds.
MinimumAge	This parameter specifies the time interval after which a file should be picked up 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. 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.
PublishSize	This parameter indicates that a file contains multiple messages and specifies how many messages should be processed at one time. For example, if a certain file has 11 records and this parameter is set to 2, then the file will be processed 2 records at a time and the final record will be processed in the 6th iteration.
jca.message.encoding	This parameter is used to override the encoding specified in the NXSD schema for the inbound File/Ftp adapter.

Table 26-11 File Adapter Service Tuning Properties

Property Name	Description
ThreadCount	If this parameter is available, the adapter creates it's 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 app gets its own in-memory queue. If the ThreadCount is set to 0, it behaves in the same manner as the SingleThreadModel. If the ThreadCount is set to -1, it begins using the global thread pool. The maximum value for this property is 40.
SingleThreadModel	If the value is true, the File/FTP Adapter poller processes files in the same thread. That is, it does not use the global in-memory queue for processing.
MaxRaiseSize	This parameter specifies the maximum number of files that the File/Ftp Adapter will submit 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 will submit 100 files every minute.

Table 26-12 File Adapter Reference Definition Properties

Property Name	Description
PhysicalDirectory	Directory path for outbound file write.
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.
FileNamingConvention	This parameter is for the naming convention for the outbound write operation file
Append	Setting this parameter to true. causes the File/Ftp Adapter to append to a file on the outbound. If the file does not exist, a new file is created.
ChunkSize	Set it to the Chunk Size for the chunked interaction operation.

Table 26-13 File Adapter Reference Tuning Properties

Property Name	Description
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 needs to be guarded as it might cause other applications/threads to starve. The maximum is 100 (same value as the maximum for dspMaxThreads in BPEL.)
UseStaging	If true, then the outbound File/Ftp Adapter writes translated data to a staging file and then it streams the staging file to the target file. If false, the outbound File/FTP Adapter does not use an intermediate staging file.
inMemoryTranslation	This parameter is applicable only if UseStaging is false If set to true, the translation step occurs in-memory i.e. an in-memory byte array is created. If set to false, then the adapter creates an output stream to the target file and allows the translator to translate and write directly to the stream.
serializeTranslation	If set to true, the translation step is serialized using a semaphore. The number of permits for semaphore (guarding the translation step) comes from ConcurrentThreshold parameter (above). If false, then the translation step occurs outside the semaphore.

Table 26-14 FTP Adapter Specific Connection Factory Properties (Properties in addition to those for file adapter)

Property Name	Description
Host	FTP server host name
Port	FTP server port
Username	FTP server user name
Password	FTP server password
DefaultDateFormat	This parameter specifies the default date format value. On the FTP server, this is the value for files that are older. The default value for this parameter is MMM d yyyy as most UNIX-type FTP servers return the last modified time stamp for older files in the MMM d yyyy format. For example, Jan 31 2012.
RecentDateFormat	This parameter specifies the recent date format value. On the FTP server, this is the value for files that were recently created.
ListParserKey	Directs the Oracle FTP Adapter how it should parse the response from the LIST command. The default value is UNIX, in which case the Oracle FTP Adapter uses a generic parser for UNIX-like FTP servers. Apart from UNIX, the other supported values are WIN /WINDOWS for Microsoft Windows NT FTP server and MVS for ftp severs running on MVS systems.
ConnectionMode	Indicates if the FTP Adapter uses the active/passive mode to connect to FTP server
UseFtps	Set to true for FTP over SSL
UseSftp	Set to true for SFTP.

Table 26-15 FTP Adapter Specific Service Definition Properties (Properties in addition to those for file adapter)

Property Name	Description
timestampOffset	This parameter is used by the FTP Adapter to address timezone issues, typically to convert the time difference between the FTP server and the system on which the FTP Adapter is running to milliseconds.
UseNlst	Set this parameter to true if you need the FTP Adapter to use the NLST FTP command rather than the LIST command that the Adapter uses by default

Table 26-16 FTP Adapter Specific Service Tuning Properties (Properties in addition to those for file adapter)

Property Name	Description
control.read.timeout	Timeout on the control socket in milliseconds.

Table 26-17 Socket Adapter Connection Factory Properties

Property Name	Description
Host	Host on which ServerSocket is running.
Port	Port on which ServerSocket is listening.
BacklogQueue	Queue length for incoming connection.
SSLEnable	Flag which enables SSL
KeepAlive	Flag to enable pooling of connection

Table 26-18 Socket Adapter Service Definition Properties

Property Name	Description
Host	Host on which ServerSocket is running
Port	Port on which ServerSocket is listening.
TransMode	Translation mode of Adapter.
Encoding	Encoding of data.
ByteOrder	ByteOrder of the data.

Table 26-19 Socket Adapter Service Tuning Properties

Property Name	Description
NIOProcessorThreadCount	Number of threads processing messages in inbound (only in NIO mode).

Table 26-20 Socket Adapter Reference Definition Properties

Property Name	Description
Host	Host on which ServerSocket is running
Port	Port on which ServerSocket is listening
TransMode	Translation mode of adapter
Encoding	Encoding of data
ByteOrder	ByteOrder of the data.

Table 26-21 UMS Adapter Connection Factory Properties

Property Name	Description
XATransaction	Specify it with value false to disable XA Transaction support on inbound. Default value is true.

Table 26-22 UMS AdapterService Definition Properties

Property Name	Description
DeliveryType	Specify the message channel to receive/send messages. Email, SMS, IM in case of receiving.
To	Address from which to receive incoming messages. One or more comma separated device addresses; for instance email addresses or mobile phone numbers.
ConsumeMode	Specifies how the adapter will receive messages from UMS. Set to poller for polling mode; set to listener for listener mode.
JavaCalloutImpl	Name of the Java class that defines custom logic for a message filtering or any other check, after message is accepted from UMS. It is a concrete implementation of ICustomCallout interface.
MessageFilters	Specify one or more message filters. A single filter would comprise of a Java Pattern String to match against incoming message's content/metadata, along with the metadata field type and the action (Accept or reject) to be taken.

Table 26-23 UMS Adapter Service Tuning Properties

Property Name	Description
InboundThreadCount	Specify the number of inbound poller or listener threads.
PollingInterval	Polling interval in seconds for poller consume mode.

Table 26-24 UMS Adapter Reference Definition Properties

Property Name	Description
DeliveryType	Specify the message channel through which to send messages. Email, SMS, IM, Voice for sending

Table 26-25 UMS Adapter Outgoing Message Properties

Property Name	Description
SendEmailAsAttachment	True to send email as an attachment.

Table 26-26 LDAP Adapter Connection Factory Properties

Property Name	Description
inboundDataSource	Jndi string location pointing to a valid XA data source.
hostName	Host name of the directory server.
port	Port where the LDAP service is running.
bindDN	dn of the entry that will be used to bind to the LDAP service.
operationTimeout	Client-side timeout defined at the connection level. If the response is not received by the DS in the timeout period, the operation will be abandoned and an exception will be raised.
useStartTLS	Use start TLS extended operation to secure communication with a directory server over a non-encrypted channel. Port in this case is listening for clear-text LDAP Connections.
useSSL	Indicates that LDAP adapter should use SSL to secure communication with the directory server. The server must be configured to listen in SSL mode and the value for the port argument must be one where the server is listening for SSL based connections.

Table 26-27 LDAP Adapter Service Definition Properties

Property Name	Description
NotificationStrategy	How are notifications going to be polled and published. Based on the Timestamp of the changeLog and if changelog, which changeLog mechanism.
EventType	If all is selected, all the events will be published. Otherwise, a comma separated list of events type to publish will be sent.
BaseDN	Valid DN under which events should be reported.
EventScope	Scope of event source under the configured base dn.
SearchFilter	Advanced filter condition. Events that satisfy the given filter condition only will be published by the Adapter. Value should be a valid string representation of LDAP filter.
TypesOnly	When set to true, only the attribute names will be returned. Otherwise, both attribute names and values will be returned.
ReturnAttributes	A list of all the attributes to return as part of the event.
ReturnAttributesDelimiter	String regex. A delimiting regular expression.

Table 26-28 LDAP Adapter Service Tuning Properties

Property Name	Description
PollingInterval	Polling interval before conducting a subsequent search for new events.
payloadSizeThreshold	Integer value representing the byte count threshold limit of the message to be published.
SizeLimit	Maximum number of entries returned as part of a search operation. This can be configured on the DS side as well. Lower of the two values will take effect. SizeLimit is enforced within a single page.
TimeLimit	Maximum time the server should wait before returning the results.
PageSize	Max number of events that should be published in a page.

Table 26-29 LDAP Adapter Reference Definition Properties

Property Name	Description
RequestControls	The Adapter constructs the appropriate control objects from this interaction spec property and passes them along with the request message.

Table 26-30 LDAP Adapter Reference Tuning Properties

Property Name	Description
SizeLimit	Maximum number of entries returned as part of a search operation. This value can be configured on the Directory Server side as well. If so, the lower of the two values takes effect.
TimeLimit	Maximum time in seconds the server should wait before returning the results.
FollowReferrals	Referral chase strategy.
HopLimit	Maximum number of permissible hops while chasing referrals.
AliasDereferencing	Behavior for handling alias entries while processing the search.
MaxDSMLRequestSize	DSML contains a batch request. This batch request can potentially contain millions of LDAP operation requests.This property is used to control the maximum number of permissible operation requests that can be passed to the LDAP adapter through a single DSML batch request.

Table 26-31 DB Adapter Service Definition Properties

Property Name	Description
PollingStrategy	Indicates how to poll for records and what to do with them after they have been read so they are only processed once.
DescriptorName	A name generated from the root table name.

Table 26-32 DB Adapter Service Tuning Properties

Property Name	Description
PollingInterval	How often to poll for new records
MaxTransactionSize	How many records to fetch at a time and process in a single transaction (not per polling interval.)
MaxRaiseSize	How many top-level records to bundle into a single XML document and hence a single process instance.
NumberOfThreads	How many threads concurrently poll for and process records.

Table 26-33 DB Adapter Reference Definition Properties

Property Name	Description
SchemaName	The schema to which the stored procedure belongs.
PackageName	The package to which the stored procedure belongs.
ProcedureName	The name of the stored procedure being executed.
SqlString	The SQL to execute
DescriptorName	A name generated from the root table name.
QueryName	The name of the EclipseLink query being executed
IsQueryByExample	If queryName not set, SQL is built from an input XML example record
DmlType	Indicates merge, insert, update or delete.

Table 26-34 JMS Adapter Connection Factory Properties

Property Name	Description
ConnectionFactoryLocation	JMS provider connection factory.
FactoryProperties	Enables parameters that establish context for remote lookup.
IsTopic	Flag that enables you to select the connection factory based on the JMS destination (topic/queue)
IsTransacted	Flag that enables you to specify if the adapter participates in local or XA transaction.

Table 26-35 JMS Adapter Service Definition Properties

Property Name	Description
DestinationName	The name of the queue or topic.
MessageSelector	A string expression (based on a subset of the SQL92 conditional expression) specifying the messages the Adapter is interested in.
DurableSubscriber	Name used to identify a durable subscription.
PayloadType	Specifies the type of JMS message.

Table 26-36 JMS Adapter Service Tuning Properties

Property Name	Description
adapter.jms.receive. threads	Poller threads created when an endpoint is activated.
adapter.jms.receive. timeout	Timeout value used for the synchronous receive call.
adapter.jms.retry. interval	The time for which the Oracle JMS Adapter waits before trying to re-create a connection after a connection is lost.

Table 26-37 JMS Adapter Reference Definition Properties

Property Name	Description
DestinationName	Name of the queue or topic
TimeToLive	Represents the message's lifetime (in milliseconds)
Priority	Represents the priority for the message.
PayloadType	Specifies the type of JMS message
DeliveryMode	Represents the delivery mode to use.

Table 26-38 JMS Adapter Reference Tuning Properties

Property Name	Description
adapter.jms.receive. timeout	Timeout value used for the synchronous receive call.
adapter.jms.retry. interval	The time for which the Oracle JMS Adapter waits before trying to re-create a connection after a connection is lost.

Table 26-39 AQ Adapter Connection Factory Properties

Property Name	Description
XADataSourceName	datasource name for xa transactions
DataSourceName	datasource name for local transactions

Table 26-40 AQ Adapter Service Definition Properties

Property Name	Description
QueueName	The name of the AQ Queue.
DatabaseSchema	The schema where the queue resides
Consumer	Dequeue message for a given consumer
ObjectFieldName	Identifies the field containing the business payload if the queue is an ADT queue.
PayloadHeaderRequired	Ensures all non- payload attributes of ADT are available for processing.
Correlation	Dequeues messages that match the value specified
DequeueCondition	Expression to allow dequeue of message based on a specific condition.

Table 26-41 AQ Adapter Service Tuning Properties

Property Name	Description
DequeueTimeOut	The interval after which the dequeue() API times out if no message is received on the inbound queue.
adapter.aq.dequeue. threads	Specifies the number of poller threads that are created when an endpoint is activated.

Table 26-42 AQ Adapter Reference Definition Properties

Property Name	Description
QueueName	The name of the AQ Queue
DatabaseSchema	The schema where the queue resides.
ObjectFieldName	Identify the field containing the business payload if the queue is an ADT queue.
PayloadHeaderRequired	Ensures all non- payload attributes of ADT are available for processing.
RecipientList	Specify the consumer name or names that are the intended recipients for the messages enqueued by the Adapter.

Table 26-43 Coherence Adapter Connection Factory Properties

Property Name	Description
CacheConfigLocation	Location of cache configuration file that defines the cache and extend client settings.
ServiceName	Name of the cache service to be associated with the connection

Table 26-44 Coherence Adapter Reference Definition Properties

Property Name	Description
CacheName	Identifies a particular Coherence cache
CacheOperation	The operation to be carried out on the Cache identified by CacheName.
Filter	Used to specify the subset of cache to which the operation should be applied.
ValueType	Fully qualified class name that identifies the object stored to/retrieved from cache.
ReturnCacheKeysOnly	Boolean that allows for only Cache identifiers (keys) to be returned
Key	Identifier for a Cache Entry
KeyType	Identifies the java type of the value to be used as the key.

Table 26-45 Coherence Adapter Reference Tuning Properties

Property Name	Description
payloadSizeThreshold	PayloadSizeThreshold decides the size of the payload that Adapter can process

Table 26-46 MSMQ Adapter Connection Factory Properties

Property Name	Description
Host	Name of the MSMQ host.
Domain	Windows Domain name of the MSMQ host.
AccessMode	Identifies if the connection factory will allow for native access or not.
TransactionMode	Identifies if the connection will participate in a transaction when sending and receiving a message.

Table 26-47 MSMQ Adapter Service Definition Properties

Property Name	Description
DestinationType	Identifies the type of queue
DestinationName	Name of the MSMQ queue.
DestinationPath	The actual string that identifies a DistributionList or Public queue as represented in ActiveDirectory
UseActiveDirectoryPath	Boolean that allows for Active Directory Path to be used to identify a public queue instead of queue name.
UseDirectFormatName	Boolean that allows for Direct Format name to be used for public and private queues.
Correlation	Correlation identifier.

Table 26-48 MSMQ Adapter Service Tuning Properties

Property Name	Description
adapter.msmq.receive.timeout	The time (in milliseconds) that Message Queuing will wait for a message to arrive before starting

Table 26-49 MSMQ Adapter Another Poll-Cycle

Property Name	Description
adapter.msmq. dequeue.threads	Number of poller threads that will be initialized when endpoint activation occurs.

Table 26-50 MSMQ Adapter Reference Definition Properties

Property Name	Description
DestinationType	Identifies the type of queue
DestinationName	Name of the MSMQ queue.
DestinationPath	The actual string that identifies a DistributionList or Public queue as represented in ActiveDirectory.
UseActiveDirectoryPath	Boolean that enables the Active Directory Path to be used to identify a public queue instead of queue name.
UseDirectFormatName	Boolean that enables the Direct Format name to be used for public and private queues.
Priority	Message priority
TimeToLive	The property specifies a time limit (in seconds) for the message to be retrieved from the target queue.
Delivery	The property is used to specify express (non-persistent) or recoverable (persistent) messaging.

Table 26-51 SAP Adapter Connection Factory Properties

Property Name	Description
ServerDataProvider_JCO_gwhost	Gateway host
ServerDataProvider_JCO_gwserv	Gateway service
ServerDataProvider_JCO_progid	Program ID of the server.
ServerDataProvider_JCO_trace	Enable/disable RFC trace.
ServerDataProvider_JCO_params	Arbitrary parameters for RFC library
ServerDataProvider_JCO_snc_myname	SNC name.
ServerDataProvider_JCO_snc_qop	SNC level of security.
ServerDataProvider_JCO_snc_lib	Path to the SNC library.
ServerDataProvider_JCO_unicode	Flags whether to connect in unicode mode.
ServerDataProvider_JCO_max_startup_delay	Maximum server startup delay time in seconds.
ServerDataProvider_JCO_connection_count	Maximum server connection threads allowed.
ServerDataProvider_JCO_dsr	Enable/Disable dsr support.
DestinationDataProvider_JCO_client	SAP client
DestinationDataProvider_JCO_user	Logon user
DestinationDataProvider_JCO_alias_user	Logon user alias
DestinationDataProvider_JCO_passwd	Logon password
DestinationDataProvider_JCO_lang	Logon language
DestinationDataProvider_JCO_saprouter	SAP router string to use for a system prot.ected by a firewall
DestinationDataProvider_JCO_sysnr	SAP system number.
DestinationDataProvider_JCO_ashost	SAP application server
DestinationDataProvider_JCO_mshost	SAP message server
DestinationDataProvider_JCO_msserv	Optional: SAP message server port to use instead of the default sapms sid
DestinationDataProvider_JCO_gwhost	Gateway host
DestinationDataProvider_JCO_gwserv	Gateway service
DestinationDataProvider_JCO_r3name	System ID of the SAP system
DestinationDataProvider_JCO_group	Group of SAP application servers
DestinationDataProvider_JCO_tpname	Program ID of external server program
DestinationDataProvider_JCO_tphost	Host of external server program
DestinationDataProvider_JCO_type	Type of remote host
DestinationDataProvider_JCO_trace	Enable/disable RFC trace
DestinationDataProvider_JCO_cpic_trace	Enable/disable CPIC trace
DestinationDataProvider_JCO_use_sapgui	Start a SAP GUI and associate with the connection
DestinationDataProvider_JCO_codepage	Initial codepage in SAP notation
DestinationDataProvider_JCO_getsso2	Get/Don't get a SSO ticket after logon
DestinationDataProvider_JCO_mysapsso2	Use the specified SAP Cookie Version 2 as logon ticket
DestinationDataProvider_JCO_x509cert	Use the specified X509 certificate as logon ticket
DestinationDataProvider_JCO_lcheck	Enable/Disable logon check at open time
DestinationDataProvider_JCO_snc_mode	Secure network connection mode
DestinationDataProvider_JCO_snc_partnername	SNC partner
DestinationDataProvider_JCO_snc_qop	SNC level of security
DestinationDataProvider_JCO_snc_myname	SNC name. Overrides default SNC partner
DestinationDataProvider_JCO_snc_lib	Path to library which provides SNC service
DestinationDataProvider_JCO_dsr	Enable/Disable dsr support
DestinationDataProvider_JCO_peak_limit	Maximum number of active connections that can be created for a destination simultaneously
DestinationDataProvider_JCO_pool_capacity	Maximum number of idle connections kept open by the destination. A value of 0 has the effect that there is no connection pooling.
DestinationDataProvider_JCO_expiration_time	Time in ms after that the connections hold by the destination can be closed.
DestinationDataProvider_JCO_expiration_check_period	Period in ms after that the destination checks the released connections for expiration.
DestinationDataProvider_JCO_max_get_client_time	Max time in ms to wait for a connection, if the max allowed number of connections is allocated by the application.
DestinationDataProvider_JCO_repository_destination	Specifies which destination should be used as repository, i.e. use this destination's repository.
DestinationDataProvider_JCO_repository.user	If repository destination is not set, and this property is set, it will be used as user for repository calls. This allows using a different user for repository lookups.
DestinationDataProvider_JCO_repository.passwd	The password for a repository user. Mandatory, if a repository user should be used.
DestinationDataProvider_JCO_repository.snc_mode	If SNC is used for this destination, it is possible to turn it off for repository connections, if this property is set to 0. Defaults to the value of DestinationDataProvider_JCO_snc_mode,

Table 26-52 SAP Adapter Service Definition Properties

Property Name	Description
Type	SAP object type
BAPIName	Name of BAPI object
RFCName	Name of RFC object
IDOCName	Name of IDOC object
ProgramID	Program ID registered at SAP
AutoSYSTAT01	Auto SYSTAT01 acknowledgment IDOC
EncodeIDOC	Encode IDOC in flat file format
Migration	Migration support for older SAP adapter

Table 26-53 SAP Adapter Reference Definition Properties

Property Name	Description
Type	SAP object type
BAPIName	Name of BAPI object
RFCName	Name of RFC object
IDOCName	Name of IDOC object
QueueName	Name of SAP inbound queue to send
Interaction	Stateful or stateless interaction
Migration	Migration support for older SAP adapter

Table 26-54 Oracle E-Business Suite Adapter Connection Factory Properties

Property Name	Description
XADataSourceName	datasource name for xa transaction
DataSourceName	datasource name for local transactions

Table 26-55 Oracle E-Business Suite Adapter Service Definition Properties

Property Name	Description
IRepInternalName	Internal name of the EBS interface from Integration Repository
PollingStrategy	How to poll for records and what to do with them after they have been read so they are only processed once.
DescriptorName	A name generated from the root table name.
QueueName	The name of the AQ Queue.
DatabaseSchema	The schema where the queue resides.
Consumer	Dequeue message for a given consumer.
Correlation	Dequeues messages that match the value specified.
DequeueCondition	Expression to allow dequeue of message based on a specific condition.
AppsEventSchema	Custom schema for business events payload.

Table 26-56 Oracle E-Business Suite Adapter Service Tuning Properties

Property Name	Description
PollingInterval	How often to poll for new records.
MaxTransactionSize	How many records to fetch at a time and process in a single transaction (not per polling interval)
MaxRaiseSize	How many top-level records to bundle into a single XML document and hence a single process instance
NumberOfThreads	How many threads concurrently poll for and process records
DequeueTimeOut	Interval after which the dequeue() API times out if no message is received on the inbound queue
adapter.aq.dequeue.threads	Specifies the number of poller threads that are created when an endpoint is activated.

Table 26-57 Oracle E-Business Suite Adapter Reference Definition Properties

Property Name	Description
IRepInternalName	Internal name of the EBS interface from Integration Repository
SchemaName	The schema to which the stored procedure belongs.
PackageName	The package to which the stored procedure belongs
ProcedureName	The name of the stored procedure being executed.
SqlString	The SQL to execute
DescriptorName	A name generated from the root table name.
QueryName	The name of the EclipseLink query being executed.
IsQueryByExample	If queryName not set, SQL is built from an input XML example record.
DmlType	Indicates merge, insert, update or delete.
DataSecurityCheck	Enables EBS function security check
APIErrorHandler	To retrieve error messages from FND_MSG_PUB message stack
QueueName	The name of the EBS Queue
DatabaseSchema	The schema where the queue resides
IRepOverloadSequence	Overload sequence from Integration Repository.
AppsFlexConfigFile	flexfield mapping configuration file name.

26.10 Scheduling JCA Adapter Endpoint Activation and Deactivation using Oracle Enterprise Scheduler

You can schedule activation and deactivation of the SOA composite JCA Adapter Services from Oracle Enterprise Manager Fusion Middleware Control.

Using Oracle Enterprise Scheduler schedule metadata you provide, you can:

Schedule a request for composite JCA Adapter service activation.
Schedule a request for composite JCA Adapter service deactivation.

Oracle Enterprise Manager Fusion Middleware Control also displays the current state of an Adapter endpoint (composite service), which can be either active or inactive.

You can also edit existing metadata to alter your schedule, and you can remove schedules for Adapters.

Note:

Because the Oracle Enterprise Scheduler installation is optional, this feature is not be available if the Oracle Enterprise Scheduler is not installed.

Follow these steps to schedule activation and deactivation of the SOA composite JCA Adapter Services:

26.10.1 Create the Schedule Metadata

To create the schedule metadata, you fill in a form by selecting Define Schedules. The form populates the metadata.

In Oracle Enterprise Manager Fusion Middleware Control, login to the Scheduling Services page, and navigate to the SOA Infrastructure menu -> Define Schedules page by using the Scheduling Services menu.

Description of the illustration GUID-1614B1BC-6C14-47E6-89FB-429D4E1B5582-default.gif
The next Oracle Enterprise Scheduler page lists schedules for submitting jobs.

Description of the illustration GUID-09236CBA-C901-4EFB-AC3F-7ACECC4B4497-default.gif
On this page, select the Create button to launch the page that helps create the schedule metadata.

Description of the illustration GUID-09236CBA-C901-4EFB-AC3F-7ACECC4B4497-default.gif
Define the schedule metadata on this page. Provide a name for the schedule, a display name, a description, frequency of activation and deactivation and start date of the schedule. Ensure you create the schedule metadata in the /oracle/apps/ess/custom/soa package.

Description of the illustration GUID-4D35EBDC-D217-4BAC-889C-E4A3F7F4A59B-default.png

26.10.2 Use the Created Schedule Metadata to Schedule the Deactivation and Activation of a SOA Composite JCA Adapter

You next use the metadata you have created to schedule the deactivation and activation of an Adapter.

Once the schedule is created, navigate back to the SOA Composite home page, and then to the Services and References page of the Composite Application or the SOA Infra page (to see Services and References across Composites).
In the Service home page, select a JCA Adapter. Select the icon provided in the top-right of the page to launch the popup to schedule the deactivation. The icon is shown in on the right side. This button activates or deactivates the endpoint when selected. It provides a manual way to activate or deactivate the schedule.

Description of the illustration GUID-09C338C2-E7B7-49BC-9B12-BAB94EA9A79D-default.gif
The popup has two sections: Deactivate and Activate. Each section has a drop-down that displays the saved schedule. Select an activation and a deactivation schedule, and select the Apply Schedules button to enable automated activation for this adapter or to refresh already applied schedules. (Both sections are mandatory.)

The Adapter endpoint status is shown with an icon on the service home page.

Select Remove Schedules to stop automated activation/deactivation for this adapter

If the Adapter already has activate/deactivate schedules set, you have the option to cancel them and to add a new schedule, or simply to cancel the schedule.

When a drop-down list appears blank, this indicates that the endpoint is no longer associated with a schedule.

Description of the illustration GUID-95991D0F-32DD-444B-ACFB-E2ED985E0999-default.png

26.10.3 Editing Oracle Enterprise Scheduler Schedule Metadata

You can edit existing metadata you have created using the Oracle Enterprise Scheduler/Oracle Enterprise Manager Fusion Middleware Control page. To do so:

Navigate to the Scheduling Services -> Job Requests -> Define Schedules page by using the Scheduling Services menu.
The existing schedules will be listed in the table. Select the one you want to modify and to select the Edit button on the table's toolbar.

Description of the illustration GUID-5F27FC32-4E4A-4C86-8D1C-7868D85E4870-default.png
The Edit Schedule metadata screen opens and displays the current state of the Schedule. Click the Change Frequency button.

Description of the illustration GUID-B3F3F242-55F0-4ECF-85E8-FDD761876AF3-default.gif
Click Yes on the warning popup that is displayed.

Description of the illustration GUID-62D02D10-DF82-4E9D-92E3-3C585BCF189A-default.png
The Schedule opens up in a editable mode, and you can make necessary modifications. If you change the schedule, it does not automatically apply to adapter activate/deactivate requests that have already been issued with that schedule. You have to reissue the activate/deactivate requests.

26.10.4 Removing Schedules from an Adapter Endpoint

You can remove schedules from an Adapter Endpoint. To do so:

After deactivation and activation schedules have been attached to the Adapter endpoint, the icon reflects the state accordingly. Select this icon to display the popup with schedules associated with this Adapter pre-selected.
Select the Remove Schedules button to remove the schedules from this Adapter endpoint.

Description of the illustration GUID-05321178-4C26-4CE6-A718-0F098CA0F7D6-default.gif
A confirmation dialog appears. Click Ok to remove the schedules.

Description of the illustration GUID-28C9760B-A0D6-4A3A-9EE8-1B0B69E43929-default.gif

26.11 Monitoring Adapter Resiliency

Resiliency deals with downstream service outages or connectivity issues that cause failures to build up within SOA. Within the context of JCA Technology Adapters, this means dealing with downstream service outages related to Adapters.

If a downstream endpoint is down or behaving sporadically, a large number of instances are forwarded to the error hospital and have to be recovered. If the endpoint is down, machine resources are wasted, as they partially process instances which are not going to complete anyway. The solution is to suspend upstream inbound adapters. With failure resiliency in place, messages wait in a queue or a topic until the endpoint is resumed.

To use resiliency, the first step is to enable it. You can enable it globally: each downstream endpoint inherits the failure resiliency configuration but you can override this resiliency for that one endpoint.

Once the upstream endpoint is suspended, periodically, one or a few messages are let into the flow. If the downstream endpoint is detected as clear, the upstream endpoint automatically resumes.

The Resiliency feature determines when a downstream endpoint is down based on system errors based on error rate heuristics (that is, M failures in N minutes.)

It then disables/suspends upstream endpoints where messages originated and leaves incoming messages in the natives system rather than erring out in SOA (Adapters, WebServices)

EDN events are still queued up in the system but not read by the subscriber.

The Resiliency feature supports JMS, AQ, DB, File and FTP Adapters.

WebService requests will be rejected.

The Resiliency feature monitors downstream endpoints and determine when the endpoints come back up by periodically processing inbound requests and re-enabling upstream endpoints if there is success in enabling a message to go through.

Resiliency provides Fusion Middleware Control dashboard notification and history for disabled endpoints; re-enabled status of upstream endpoints and enables upstream endpoints to be resumed from Fusion Middleware Control.

For complete information, see the section on resiliency in this guide.

26.11.1 Adapter Properties for Resiliency

You can define adapter properties in Fusion Middleware Control (in Adapter properties screen) and by using JDeveloper, the WebService properties are set using MBeans in Fusion Middleware Control and the same way as Adapters in JDev (composite bindings). Note that EDN subscribers cannot override resiliency properties.