You can install data handlers as part of either the IBM WebSphere InterChange Server or the WebSphere Business Integration Adapters product. The following sections describe the installation environment and the steps to install data handlers:
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.
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
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, which installs them automatically.
To install the separate XML or EDI data handlers, you must follow the instructions in Installing data handlers using the graphical installer or Installing data handlers silently.
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
You must do the following to install the separate XML and EDI data handlers using the graphical installer:
On the Windows platform, the field defaults to the value contained in the CROSSWORLDS environment variable, which is set by the either the WebSphere InterChange Server Installer or the WebSphere Business Integration Adapters Installer for adapter framework.
On the UNIX platform, the installer queries an entry in a file created by either the adapter framework installer or the WebSphere InterChange Server installer.
For more information on installing WebSphere InterChange Server, see the System Installation Guide for Windows
At the product directory screen, perform one of the following tasks:
You must do the following to perform a silent installation of the separate XML and EDI data handlers:
Table 8. Silent installation options for data handlers
Option name | Option values |
---|---|
-W installLocation.active |
|
-W installLocation.value |
Set to the directory path in which InterChange Server is installed. If you leave this option commented, the product installs to the default directory listed in . This option is only relevant for the WICS broker when installed on Windows. Make sure it is commented out when installing for the WMQI or WAS brokers, or when installing on a UNIX computer. |
-G replaceExistingResponse |
Set to yesToAll or yes to replace all files found on the system that have the same name as those being copied by the installer. Set to noToAll or no to not replace any files found on the system that have the same name as those being copied by the installer. |
-G replaceNewerResponses |
Set to yesToAll or yes to replace all files found on the system that are newer than those being copied by the installer. Set to noToAll or no to not replace any files found on the system that are newer than those being copied by the installer. |
-G createDirectoryResponse |
Set to yes to create the product directory specified by the option if it does not already exist. Set to no to not have the product directory created if it does not exist. You must set this option to yes if the specified directory does not exist for the installation to succeed. |
-G removeExistingResponse |
This option is not relevant for any broker on any platform. Comment out this option. |
-G removeModifiedResponse |
This option is not relevant for any broker on any platform. Comment out this option. |