Special characteristics of multiple resource adapter mode

In a multiple resource adapter configuration, several resource adapters work together with one proxy instance. A maximum of 32 resource adapter instances are possible for each proxy instance. A unique index is assigned to each resource adapter instance. This index must be entered in the file ra.xml, see below.

Multiple resource adapter mode is possible for both outbound communication via OSI-TP / LU6.2 and for inbound communication.

In multiple resource adapter mode, you must perform the following configuration steps in the application server for each resource adapter:

• In the file ra.xml, define the index "Adapting the ra.xml file" in Defining general properties in ra.xml of the resource adapter using the additional configuration property resourceAdapterIndex. This may also be possible via the Management Console as in standard operation providing that certain requirements are fulfilled, see "Adapting the ra.xml file" in Defining general properties in ra.xml .

  If you assign the indices manually, you must make sure that each resource adapter is given a unique index. In the case of inbound communication, you require this unique index to configure the inbound message endpoints via the Management Console (see Configuring inbound message endpoints).

• Perform the other configuration steps at the application server in exactly the same way as in default resource adapter mode, see Configuration steps for outbound and inbound communication .

resourceAdapterIndex

resourceAdapterIndex defines the index of the associated resource adapter instance in a multiple resource adapter configuration.

This property is only of any significance in a multiple resource adapter configuration with several resource adapter instances and must not be specified at the same time as the resourceAdapterAddresses property (see Special characteristics in cluster operation ).

Definition:	<index>
Explanation:	<index> is a number between 1 and 32. It is defined by the Management Console if the ra.xml is configured using the Management Console.
Default:	No default value
Example:	<config-property> <description>Index of this resource adapter instance in a multi-resource-adapter configuration. </description> <config-property-name>resourceAdapterIndex </config-property-name> <config-property-type>java.lang.String </config-property-type> <config-property-value>5 </config-property-value> </config-property>