user manual

302 BES Developer’s Guide
Deployment Descriptors for the Resource Adapter
values for configuration parameters which exist in the ra.xml deployment
descriptor. A minimum set of this information is required for deployment. The
following is an example of ra-borland.xml:
<connector>
<connection-factory>
<factory-name>shmeAdapterConnectionFactory</factory-name>
<factory-description>SHME Resource Adapter Connection Factory</
factory-description>
< j n d i -name>serial://shme/shmeAdapterConnectionFactory</jndi-name>
<ra-libraries>/usr/local/shme/Adapter/lib/shmeEisSdkUnix.so</ra-
libraries>
<pool-parameters>
<initial-capacity>0</initial-capacity>
<maximum-capacity>10</maximum-capacity>
<capacity-delta>1</capacity-delta>
<cleanup-enabled>true</cleanup-enabled>
<cleanup-interval>60</cleanup-interval>
</pool-parameters>
<security-map>
<description>Map of billing staff users to the EIS operator
identity</description>
<user-role>billing</user-role>
<run-as>
< d e s cription>SHME EIS application operator</description>
<role-name>SHME_OPR</role-name>
<run-as>
</security-map>
</connection-factory>
</connector>
Configuring the <ra-link-ref> element
The optional <ra-link-ref> element allows you to associate multiple deployed
Resource Adapters with a single deployed Resource Adapter. This provides
for linking and reusing resources already configured in a base Resource
Adapter to another Resource Adapter, modifying only a subset of attributes.
Use of the <ra-link-ref> element avoids duplication of resources (for example,
classes, JARs, images, etc.) where possible. Any values defined in the base
Resource Adapter deployment are inherited by the linked Resource Adapter
unless otherwise specified.
When using <ra-link-ref>, perform one of the following:
■
Assign the <maximum-capacity> element to zero (0) using the DDEditor. This
allows the linked Resource Adapter to inherit its <pool-parameters> element
values from the base Resource Adapter.
■
Assign the <maximum-capacity> element to any value other than zero (0). The
linked Resource Adapter will inherit no values from the base Resource
Adapter. With this option, all of the <pool-parameters> element values for the
linked Resource Adapter must be specified.