You can install data handlers as part of either of the following IBM
WebSphere products:
- IBM WebSphere InterChange Server
- IBM WebSphere Business Integration Adapters
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.
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.
