Data Transformation Engine Resource Adapter Reference Guide

Chapter 1 - Resource Adapters Multiple Adapter Versions

Resource Adapters Reference Guide

Multiple Adapter Versions

For some adapters, multiple-versions are provided to support different releases of

the resource with which the adapter is communicating. They are controlled by the

adapters.xml file, which is provided in the default installation directory.

The adapters.xml file lists the multiple-version of the adapter, with the specified

version uncommented. You must edit the adapters.xml file to comment out the

adapter that you do not want to use. The XML comment syntax uses the

exclamation point as a "not this" indicator:

<!-- <M4Adapter name="

not_this_adapter

-->

For example:

<M4Adapter name="TIB/RV" alias="RV" id="109" type="msg"

library="m4tibrv6" version="6.x" />

<!-- <M4Adapter name="TIB/RV" alias="RV" id="109" type="msg"

library="m4tibrv6" version="5.x"/> -->

The syntax of the adapters.xml file shows that the TIB/RV adapter version 6.x

is currently enabled and the 5.x version is commented out. Ensure that only one

version of an adapter is uncommented.

Note If more than one version of an adapter exists in the adapters.xml file, the file will

fail processing. In addition, there will be no adapters listed in the Type setting in

the Database Definition dialog box in the Database Interface Designer.

Editing the adapters.xml File

To comment out an adapter line in the adapters.xml file, you must insert the

XML comment syntax, which consists of the following:

After the less than sign (<) is the exclamation point (!) as a "not this" indicator,

followed by two dashes (--). The adapter line that consists of the adapter name,

alias, id, type, library, and version information for the specific adapter follows. The

adapter line is then closed with the syntax of two dashes (--) and a greater than

(>) sign.