Release Notes for Version 1.0.0 of the IBM WebSphere
Business Integration Adapter for TCP/IP
These release notes cover release information for version 1.0.0 of the IBM(R) WebSphere(R) Business Integration Adapter for TCP/IP. These release notes contain the following sections:
Note: Important information about this product may be available
in Technical Support Flashes issued after these release notes were published.
These can be found on the WebSphere Business Integration support Web site,
http://www.ibm.com/websphere/integration/wbiserver/support.
Select the component area of interest and search the flashes section.
Features
Features provided in this release include the following:
- The WebSphere Business Integration Adapter for TCP/IP is bi-directional. For
request processing (outbound of WebSphere Business Integration), the adapter
connects to an application's TCP/IP listener and sends a stream of data
obtained from a data handler call. The adapter expects an answer from
the application in the form of a reply data stream. For event processing
(inbound to WebSphere Business Integration), the adapter opens a TCP/IP
listener that expects data streams from applications.
- A single run time instance of the adapter supports client connectivity
to multiple applications.
- A single run time instance of the adapter supports server connectivity
from multiple applications.
- The WebSphere Business Integration Adapter for TCP/IP supports pre-processing
and post-processing, such as stripping enveloping characters from inbound
messages and adding them back to outbound messages.
Refer to the Adapter
for TCPIP User Guide for detailed information about the adapter
and the new features.
Hardware and software requirements
Hardware and software requirements are included in the product documentation.
See Installation, migration, upgrade, and configuration
information for links to those guides.
Installation, migration, upgrade, and configuration
Whether you are installing the software from the CD or downloading it from
Passport Advantage and installing it from a local directory, refer to the
appropriate guide:
These guides also include general migration, upgrade, and configuration
information.
For hardware and software requirements and configuration information specific
to this adapter, refer to the Adapter
for TCPIP User Guide.
Upgrade notes
- Note: You must open all language-specific
files (except English) in a UTF-8 encoding-enabled editor, such as Internet
Explorer or Netscape Navigator.
- Integration broker is InterChange Server
- Using an internationalized adapter with a supported
locale requires that the InterChange Server databases (including the repository)
provide support for that locale's encoding. Therefore, part of the upgrade
process involves the creation of InterChange Server databases that support
the UCS-2 and UTF-8 character encodings. The upgrade instructions in the
System Installation Guide include information on how to perform this database
creation.
- See the System Installation Guide for UNIX or for Windows for upgrade information.
- Integration broker is WebSphere MQ Integrator
Broker
- Be sure to upgrade to version 2.2.x, 2.3.x,
or 2.4.0 of WebSphere Business Integration Adapter Framework before installing
this version of the adapter. Refer to Implementing Adapters with WebSphere MQ Integrator Broker
for upgrade information.
- The locales for WebSphere MQ Integrator Broker,
the adapter, and the application must be the same.
WebSphere Business Integration Adapters API and run
time
Make sure that you run this version of the adapter with WebSphere Business
Integration Adapters run-time version 1.7.0 or later.
The WebSphere Business Integration Adapters API .jar files and the associated
scripts (CWConnEnv.bat and CWODAEnv.bat for Windows(R);
CWConnEnv.sh and CWODAEnv.sh for UNIX platforms) are installed by the WebSphere
Business Integration Adapters API. Before installing the adapter, make sure
that the WebSphere Business Integration Adapters run time is installed. If
the version is not 1.7.0 or later, you must download the latest WebSphere
Business Integration Adapters API. This section provides instructions for
verifying the API version, downloading the latest version, and enabling
the adapter to run on various versions of WebSphere InterChange Server and
Adapter Development Kit (ADK).
Verifying the run-time version
To check the version of the run time, locate the manifest file (ProductDir\lib\WBIA.jar)
and open it in a suitable Java JAR editor. Look for the following lines:
Implementation-Title: "CWConnectorAPI"
Implementation-Version: 1.7.0
The line Implementation-version indicates the installed version of the
API. If the version is not 1.7.0 or later, you must download the latest run
time.
Downloading the run time
To download the latest version of the run time:
- Go to http://www.ibm.com.
- Click the Support & downloads tab.
- Under the Downloads heading, click Downloads & drivers.
- In the Enter search terms field, type "wbia api" and click
Submit.
After you download and install the run time, you should see the following
files:
lib\WBIA.jar
lib\WBIA\3.0.0\WBIA.jar
lib\WBIA\4.0.0\WBIA.jar
lib\WBIA\4.1.1\WBIA.jar
lib\WBIA\4.2.0\WBIA.jar
bin\CWConnEnv.bat (Windows)
bin/CWConnEnv.sh (UNIX)
bin\CWODAEnv.bat (Windows)
bin/CWODAEnv.sh (UNIX)
connectors\messages\CwConnectorAgentMessages.txt
Enabling adapters for earlier versions of Adapter Development Kit and
WebSphere InterChange Server
To enable an adapter to work with various versions of ADK or WebSphere
InterChange Server, follow the appropriate procedure below:
InterChange Server versions 4.1.x (except 4.1.0), ADK versions 2.1.x
Windows: In CWConnEnv.bat, set the CWVERSION variable to 4.1.X:
set CWVERSION="4.1.X"
UNIX: In CWConnEnv.sh, set the CWVERSION variable to 4.1.X:
set CWVERSION="4.1.X"
InterChange Server versions 4.2.0 and 4.2.1, ADK versions 2.3.0 and 2.3.1
Windows: In CWConnEnv.bat, set the CWVERSION variable to 4.2.:
set CWVERSION="4.2"
UNIX: In CWConnEnv.sh, set the CWVERSION variable to 4.2:
set CWVERSION="4.2"
Running an Object Discovery Agent (ODA) against InterChange Server versions
4.1.x (except 4.1.0), ADK versions 2.1.x
Windows: In bin\CWODAEnv.bat, set the CWVERSION variable to 4.1.X:
set CWVERSION="4.1.X"
UNIX: In bin/CWODAEnv.sh, set the CWVERSION variable to 4.1.X:
set CWVERSION="4.1.X"
Running an Object Discovery Agent (ODA) against InterChange Server versions
4.2.0 and 4.2.1, ADK versions 2.3.x
Windows: In bin\CWODAEnv.bat, set the CWVERSION variable to 4.2:
set CWVERSION="4.2"
UNIX: In bin/CWODAEnv.sh, set the CWVERSION variable to 4.2:
set CWVERSION="4.2"
Documentation
Product documentation is not included as part of the product package, either
by CD or by electronic product distribution. The documentation for this
product can be found in the following InfoCenters:
To obtain the product documentation, visit the Web site and download the
current documentation set for the release that you are using. Follow the

instructions provided on the InfoCenter page to complete the installation.