user manual

300 BES Developer’s Guide
Deployment Descriptors for the Resource Adapter
7 Create the Resource Adapter Archive:
jar cvf resource-adapter-archive.rar -C staging-directory
This command creates a RAR file that you can deploy to the server. The -C
staging-directory option instructs the JAR command to change to the
staging-directory so that the directory paths recorded in the RAR file are
relative to the directory where the Resource Adapters were staged.
One or more Resource Adapters can be staged in a directory and
packaged in a JAR file.
Deployment Descriptors for the Resource Adapter
The Borland Enterprise Server uses two XML files to specify deployment
information. The first of these is ra.xml, based on Sun Microsystems' DTD for
resource adapters. The second is Borland's proprietary ra-borland.xml, which
includes additional deployment information necessary for Borland Enterprise
Server.
Configuring ra.xml
If you do not already have an ra.xml file associated with your Resource
Adapter, it is necessary to manually create a new one or edit an existing one.
You can use a text editor or the Borland DDEditor to edit these properties. For
the most up-to-date information on creating an ra.xml file, refer to the
Connectors specification at http://java.sun.com/j2ee/connector.
Configuring the Transaction Level Type
It is of critical importance that you specify the transaction level type supported
by your Resource Adapter in the ra.xml deployment descriptor. The following
table shows the transaction levels supported and how they are rendered in
XML.
Configuring ra-borland.xml
The ra-borland.xml file contains information required for deploying a Resource
Adapter to the Borland Enterprise Server. Certain attributes need to be
Transaction Support Type XML representation
None <transaction-support>NoTransaction</
transaction-support>
Local <transaction-
support>LocalTransaction</
transaction-support>
XA <transaction-support>XA</transaction-
support>