user manual

Chapter 27: Using VisiConnect 301
Deployment Descriptors for the Resource Adapter
specified in this file in order to deploy the RAR file. This functionality is
consistent with the equivalent .xml extensions for EJBs, EARs, WARs, and
client components for the Borland Enterprise Server.
Until Borland-specific deployment properties are provided in the
ra.borland.xml file, the RAR cannot be deployed to the server. The following
attributes must be specified first in ra-borland.xml:
■
Name of the connection factory
■
Description of the connection factory
■
JNDI name bound to the connection factory
■
Reference to a separately deployed connection factory that contains
Resource Adapter components which can then be shared with the current
Resource Adapter.
■
Directory where all shared libraries should be copied
■
Connection pool parameters that set the following behaviors:
■
the initial number of managed connections the server attempts to
allocate at deployment time
■
the maximum number of managed connections the server allows to be
allocated at any one time
■
the number of managed connections the server attempts to allocate
when fulfilling a request for a new connections
■
whether the server attempts to reclaim unused managed connections to
save system resources
■
the time the server waits between attempts to reclaim unused managed
connections
■
the frequency of time to detect and reclaim connections that have
exceeded their usage time
■
the amount of usage time allowed for a connection
■
Values for configuration properties defined in a <config-entry> element of
the Sun standard Resource Adapter deployment descriptor
■
Mapping of security principals for Resource Adapter/EIS sign-on
processing. This mapping identifies resource principals to be used when
requesting EIS connections for applications that use container-managed
security and for EIS connections requested during initial deployment.
■
A flag to indicate whether logging is required for the
ManagedConnectionFactory or ManagedConnection classes.
■
The file to store logging information for the two aforementioned classes
Anatomy of ra-borland.xml
The Borland-specific deployment descriptor carries information for defining a
deployable Resource Adapter Connection Factory. It provides for complete
specification of all configurable connection factory parameters including
connection pool parameters, security parameters, and the ability to define