user manual

306 BES Developer’s Guide
The ra-borland.xml deployment descriptor DTD
Resource Adapter. Borland Enterprise Server implicitly assigns a deployment
name that matches the filename of the RAR file or deployment directory
containing the Resource Adapter. This logical name can be used to manage
the Resource Adapter after the server has started. The Resource Adapter
deployment name remains active in the Borland Enterprise Server until the
module is undeployed.
The ra-borland.xml deployment descriptor DTD
This section provides a complete reference to the Borland Enterprise Server-
specific XML deployment properties used in the VisiConnect Resource
Adapter Archive and an explanation of how to edit the XML deployment
descriptors.
Editing Descriptors
You may either edit the descriptor with the Borland DDEditor or manually
using an ASCII text editor. Information on using the DDEditor to edit
descriptors is provided in Chapter 5, "Using the Deployment Descriptor
Editor," in the Borland Enterprise Server User's Guide.
If you choose to edit the descriptor manually, use an ASCII text editor which
does not reformat the XML or insert addition characters that could invalidate
the file. (Remember, this file must conform to the DTD--being well-formed is
not sufficient.) You must be careful to use the correct case for file and
directory names, even if the host operating system ignores case. You may set
default values for an element either by omitting it entirely or leaving the value
blank.
DOCTYPE Header Information
You must supply the correct DOCTYPE header for each descriptor you create.
Using incorrect elements within the DOCTYPE header can result in parsing errors
which may be difficult to diagnose.
The header refers to the location and version of the Document Type Definition
(DTD) file of the deployment descriptor. Although this header references an
external URL at java.sun.com, the Borland Enterprise Server contains its own
local copy of the DTD file, so that the host server need not require Internet
access. However, the <!DOCTYPE ... > element must still be included in the
ra.xml file, and it must reference the external URL, as the version of the DTD
defined in this element is used to identify the version of the deployment
descriptor.