Installing data handlers

You can install data handlers as part of either of the following IBM WebSphere products:

Data handlers in IBM WebSphere InterChange Server

The IBM WebSphere InterChange Server product includes the base data-handler file, CwDataHandlers.jar. Therefore, this product includes the data handlers that Table 3 lists. The Server Access Interface process (within InterChange Server) can access any of the data handlers in the CwDataHandlers.jar file. The InterChange Server Installer automatically installs this data-handler file. For the use of the InterChange Server Installer, follow the instructions in the System Installation Guide for UNIX or for Windows.

Note:
To use additional IBM-delivered data handlers with InterChange Server, you must purchase the IBM WebSphere Business Integration Adapters product. This product includes all IBM-delivered data handlers as well as the sample data-handler code to assist in the development of custom data handlers.

When the installation is complete, the files in Table 6 are installed in the product directory on your system.

Table 6. Installed file structure for data handlers in WebSphere InterChange Server

Directory Description
DataHandlers Contains the file CwDataHandler.jar for compiled versions of the IBM-delivered data handlers.
repository\edk Contains text files with meta-object definitions for data handlers called in the context of the Server Access Interface (used with the InterChange Server integration broker).

Note:
In this chapter, backslashes (\) are used as the convention for directory paths. For UNIX installations, substitute slashes (/) for backslashes. All pathnames are relative to the product directory, which is the directory where the WebSphere business integration system is installed.

Data handlers in IBM WebSphere Business Integration Adapters

The IBM WebSphere Business Integration Adapters product includes all IBM-delivered data handlers (see IBM-delivered data handlers). To install the data handlers, use the WebSphere Business Integration Adapters Installer. When you choose an adapter that requires a data handler, Installer automatically selects the data handler to install. You can also explicitly choose data handlers for Installer to install. Follow the instructions in the Implementating Adapters with WebSphere MQ Integrator Broker or Implementating Adapters with WebSphere Application Server.

When the installation is complete, the files in Table 7 are installed in the product directory on your system.

Table 7. Installed file structure for data handlers in WebSphere Business Integration Adapters

Directory Description
DataHandlers Contains the file CwDataHandler.jar for compiled versions of the IBM-delivered base data handlers, as well as the jar files for the special data handlers (XML and EDI). Also contains an empty jar file, CustDataHandler.jar, which is intended to hold any custom data handlers you might develop.
DevelopmentKits\edk\DataHandler Contains a template file (StubDataHandler.java) for a custom data handler and a batch file (make_datahandler.bat)to compile a custom data handler.
DevelopmentKits\edk\DataHandler\Samples Contains source code for the sample FixedWidth, NameValue, and Delimited data handlers.
repository\DataHandlers Contains text files with meta-object definitions for data handlers called in the context of a connector.

Note:
In this chapter, backslashes (\) are used as the convention for directory paths. For UNIX installations, substitute slashes (/) for backslashes. All pathnames are relative to the product directory, which is the directory where the WebSphere business integration system is installed.

Copyright IBM Corp. 1997, 2003