Adapter framework changes

Unlike previous releases of the adapter framework, Adapter Framework 2.6 software is bundled separately from ICS. This makes possible separate installations and a more flexible enhancement path for both the adapter framework and ICS. It also isolates the adapter framework from releases prompted solely by broker enhancements, and vice versa. This section discusses these and other changes to the adapter framework that may affect adapter installation.

Note:
To take advantage of new features in Adapter Framework 2.6, you must install and configure ICS 4.3 as integration broker. These new features include:

If you configure the new adapter framework with ICS 4.2.2 as an integration broker, these features will not be available. To uninstall ICS 4.2.2 and install ICS 4.3, see the System Installation Guide for your platform.

.jar files and directories

Through release 2.4, the adapter framework was shipped in a crossworlds.jar file. The adapter framework, beginning with version 2.6, is packaged and delivered in a separate file, wbiart.jar.

Environment variables

Previously released adapters and adapter frameworks were installed in the same file and directory as ICS. The task of migrating adapters and ODAs to the new adapter framework begins with changing environment variables in adapter and ODA scripts to point to the new file and location of the 2.6 version of the adapter framework (where you installed the wbiart.jar file). Because the new adapter framework resides in a file and in a directory other than that of ICS, you must modify the environment variables in scripts for adapters and ODAs issued as part of previous releases. For further information, see the Migrating Adapters to Adapter Framework, Version 2.6 guide.

If you are configuring Adapter Framework 2.6 with an integration broker that resides on separate machine, you must also modify the adapter start script to point to the remote integration broker. Alternatively, you can modify the adapter configuration file to point to the queue manager of the remote integration broker. For further information, see the Connector Development Guide and the Connector Configurator section of any adapter guide.

JRE 1.4 compatibility

Adapter Framework 2.6 uses Java TM Runtime Environment (JRE) 1.4 and higher. Adapters released with previous versions of the framework used earlier versions of the JRE. For example, Adapter Framework 2.4 supported JRE 1.3.1

Start scripts

If you want to migrate adapters and ODAs released with Adapter Framework 2.4, you must modify their start scripts to point to the new location and file name of Adapter Framework 2.6. For a high-level description of these changes, see Environment variables. For a detailed account of adapter- and ODA-specific changes to those scripts, see the Migrating Adapters to Adapter Framework, Version 2.6 guide.

Copyright IBM Corp. 1997, 2004