Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

Special characteristics of multiple resource adapter mode

&pagelevel(3)&pagelevel

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

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