Data Transformation Engine Resource Adapter Reference Guide

Chapter 1 - Resource Adapters Configuring Java-Based Adapters

Resource Adapters Reference Guide

Configuring Java-Based Adapters

Jar files included with Mercator software and installed in the install_home\

directory are normally added to the CLASSPATH environment variable

automatically as in the case of the Command Server and the Event Server. You

must modify the CLASSPATH environment variable for all Java-based adapters

that rely on external .jar files in order to execute properly.

This can be done directly, or by adding the .jar files to the mercator.ini file. To

do so, add entries to the [External Jar Files] section. Refer to the Event Server

Reference Guide for more information on the mercator.ini file.

For example:

[External Jar Files]

jar1=c:\J2EE\lib\j2ee.jar

jar2=c:\mypath\myjar.jar

Note A full path must be used in the mercator.ini file.

UNIX Only

For all Java components the directories containing the Java Virtual Machine (JVM)

libraries need to be in the library path environment variable. Typically, this is

already defined in the environment, however if it is not, then it must be manually

added to the library path environment variable. The following environment

variables exist for:

UNIX Platform Environment Variable

AIX

LIBPATH

Solaris

LD_LIBRARY_PATH

HP-UX

SHLIB_PATH

API Usage

When a map is invoked using the Java or CORBA API, where the main process

starts with the java command, all necessary .jar files from the install_home\

directory and external .jar files related to the adapter must be added to the

CLASSPATH environment variable manually.