Release Notes for Version 6.0.0 of the IBM WebSphere Business Integration Adapter for mySAP.com (for SAP R/3, Version 3.x)

These release notes cover release information for Version 6.0.0 of the IBM WebSphere Business Integration Adapter for mySAP (for SAP R/3, Version 3.x). These release notes contain the following sections:
New in this release Installation, migration, upgrade, configuration
Product fix history WebSphere Business Integration Adapters API and run time
Backward compatibility Documentation updates
Hardware and software requirements

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. Click the product you are interested in; if flashes are available, they are located in Self help > Solve a problem > Flashes (Alerts).

New in this release

New features and improvements made in this release include the following:

New language support

The adapter provides support for bidirectional (bi-di) data for the adapter running on Windows and connecting with SAP Web Application Server version 6.20 and higher Unicode systems exclusively.

Refer to the Adapter for mySAP.com (SAP R/3 V. 3.x) User Guide for detailed information about the adapter and the new features.

Product fix history

Between release 5.5.0 and 6.0.0, the following problems, based on customer-reported cases, were fixed.
Tracking
number
Description
42920 In the ODA, the Search By Description node down the RFC node does not generate its corresponding business object correctly.
36006 The adapter does not use the configured connector property value for AleEventDir to create the Request folder, which holds the status message files for ALE request processing using TID management.
35673 When using IDoc files from SAP R/3 4.7 systems, the application-specific information generated in the business objects is incorrect.
35387 The setting of the space characters that pad the fields in a segment when it is sent to SAP has been corrected.
35192 Performance degrades when the Request directory fills up with many status files for ALE request processing.
34614 During startup, when the SAP JCo files are not installed, the SAP Adapter logs a misleading error saying that JCO files are missing. The connector now logs the proper message.
34205 When the SAP server shuts down abruptly, request events are lost during request processing.
33144 During request processing, the ObjectEventId is dropped in the response object. This has been corrected. In the Extension Module, the value of ObjectEventId is preserved for request processing.
32731 Beginning with InterChange Server version 4.2.0 and WebSphere Business Integration Adapters version 2.3.0, connector configuration properties are no longer case sensitive.

Backward compatibility

Beginning with adapter version 5.2.3, formatting delimiters were removed from the DATE and TIME field values of objects for the RFC Server and BAPI modules. This was done so that values accurately conform to the maximum character lengths specified in the business object: eight for DATE and six for TIME; the delimiters inaccurately extended both of these by two.

If you want to maintain the delimiters (for example, when you are using existing map or collaboration content that expects this format), set the new configuration property DateTimeFormat to Legacy so that DATE and TIME field values retain their formatting delimiters.

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 the Passport Advantage Web site and installing it from a local directory, refer to the appropriate guide for your integration broker:

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 mySAP.com (SAP R/3 V. 3.x) User Guide.

Upgrade notes

Note: For the ALE Module only: Before upgrading to this version of the adapter from one of the following versions, perform the steps listed beneath the section pertaining to your version:

After you have finished, apply the upgrade and follow the configuration instructions in the Adapter for mySAP.com (SAP R/3 V. 3.x) User Guide.

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.8.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.8.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.8.0

The line Implementation-version indicates the installed version of the API. If the version is not 1.8.0 or later, you must download the latest run time.

Downloading the run time

To download the latest version of the run time:

  1. Go to http://www.ibm.com.
  2. Click the Support & downloads tab.
  3. Under the Downloads heading, click Downloads & drivers.
  4. 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
bin\CWConnEnv.bat (Windows)
bin/CWConnEnv.sh (UNIX)
bin\CWODAEnv.bat (Windows)
bin/CWODAEnv.sh (UNIX)
connectors\messages\CwConnectorAgentMessages.txt

Documentation updates

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 Information Centers:

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 Information Center page to complete the installation.

Copyright IBM Corp. 1997, 2004