In a multiple resource adapter configuration (s. chapter Multiple resource adapter mode), 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.
The multi-resource adapter operation serves a special case of inbound communication, and has no effect on outbound communication via OSI TP / LU6.2.
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 propertyresourceAdapterIndex
. 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 index manually, you need to consider the following:
Each Resource Adapter must have 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).
- For each resource adapter index except 1 you have to add 1000 user statements USER BCUij000 to USER BCUij999 in the file
input.own
in the proxy container directory<Proxy_home>/def
e.g. for the resource adapter index 12 you have to add the USER statements USER BCU12000 to USER BCU12999.
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.
Cluster operation and multiple resource adapter mode are mutually exclusive.
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: |
|
Explanation: |
|
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> |