Release Notes for WebSphere InterChange Server, Version 4.3, for Windows

These release notes cover release information for WebSphere(R) InterChange Server(TM), Version 4.3, for Windows(R). They contain the following sections:
New in this release Installation, migration, upgrade, and configuration information
Product fix history Known problems and workarounds
Hardware and software requirements Documentation

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.

New in this release

This section lists the new features and improvements made in this release.

Product fix history

Between releases 4.2.2 and 4.3, the following problems, based on customer-reported cases, were fixed.

Server

Tracking number

Description

23061

If an LLBP collaboration receives a response to an inbound service call while the collaboration is stopped, then the response is not processed when the collaboration is restarted. This has been fixed.

23248

If validate database connection is selected from the Server View, error messages are printed in the ICS log. No feedback is given in the GUI. This has been fixed.

23879

If a collaboration is in an in-doubt state, System Monitor incorrectly displays the status color in red instead of yellow. This has been fixed.

24374

If a collaboration is in a paused state before shutting down the ICS, the collaboration displays as inactive after ICS is restarted. This has been fixed.

28505

Setting OAThreadMax and OAThreadMaxIdle in the InterchangeSystem.cfg does not apply to the ORB. To specify these two properties, add -Dcom.ibm.CORBA.ThreadPool.MaximumSize=your_specified_size and -Dcom.ibm.CORBA.ThreadPool.InactivityTimeout=your_specified_time to the CWSharedEnv.bat file. Also, to specify other CORBA properties, such as OAport, manually add the property to the configuration files (either the InterchangeSystem.cfg file or adapterConfig.cfg file) in the "CORBA" section. This has been fixed.

29964

The Schema name for the Flow Monitoring Table (used for WebSphere Business Integration Monitor integration) is not configurable in InterChange Server. ICS does not use a schema name; instead, it defaults to the name of the data source user. If the schema name and user name are different for the WebSphere Business Integration Monitor data source, ICS may not find the required table. This has been fixed.

31133

When flow monitoring is turned on for a group collaboration, the ENTER_COLLABORATION event of a child collaboration might be recorded before the START_SERVICE_CALL event of the parent collaboration. This changes the order in which events are recorded in the database. This has been fixed.

32119

Maps that are deployed from System Manager are automatically started. However, if the deployed map is stopped and restarted after deployment, System Manager returns the error "Map has already been activated." The map cannot restarted. This behavior occurs, too, when maps are deployed using repos_copy. This has been fixed.

InterChange Server Installer

Tracking number

Description

21313

The summary panel shows an incorrect amount of disk space required for installation. For a full installation, add approximately 6 MB to the displayed space requirements.

32070

Uninstaller fails to remove InterChange Server from the Windows Service registry.

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 information

For hardware and software requirements, installation, migration, upgrade, and configuration information specific to this product, refer to the System Installation Guide for Windows.

Installation notes

Migration notes

For migration information, refer to the migration section of the System Installation Guide for Windows.

Known problems and workarounds

The following problems have been found in this release:

Server

Tracking number

Description

24123

The temporary string variables declared for map transformations are not initialized and they have a null value. So during map transformations, data conversions on these variables with null values using DtpDataConversion.toXXX(Object objectData) throw DtpIncompatibleFormatException.

29159

System Manager hangs when you right-click to stop a collaboration during debugging a break point; you cannot do anything on the GUI, including finishing the debugged flow. This happens in the debugger because a collaboration with running flows cannot be stopped. The System Manager process must be killed manually

31603

InterChange Server messages (including log messages and other informational messages) are not localized. These messages are in English, and some of the ICS tools display these messages in English even if the tool is set up for a non-English locale.

42846

System Monitor cannot count events that fail connectors in the Server Statistics view.
43023 Database-specific SQL reserved words should not be used while creating attributes in a relationship. Their use results in JDBC exceptions while creating the appropriate tables in the underlying database. For example, the SQL reserved words "index", "key", "char", and "table" should not be used in naming the relationship attributes. This exception occurs on SQL2000 on all platforms InterChange Server supports. Also avoid using these words when choosing other databases.
43439 When a JMS agent fails, the server is not notified until the heartbeat thread times out, which can take as long as 2 minutes. During this time, the same event might be sent twice to the agent because the collaboration thread can send the request to the agent, and the request sits in the queue. When the heartbeat thread times out, the waiting collaboration thread puts the same event in the failed event table. When the agent starts again, the same event is resubmitted.
43441/43549 The composite identity relationship (an identity relationship used to relate both parent business object and child business object) feature does not function in ICS 4.3. To use this feature, contact IBM Technical Support.
43940 On Windows platforms, if the command line for starting the agent is too long, the Object Activation Daemon cannot start connector agent. This is a problem in WebSphere MQ. The PMR number is 24059 49R. Contact IBM Technical Support if you encounter this problem..

InterChange Server Installer

Tracking number

Problem

20432

No error message is returned when you enter Japanese characters for the InterChange server name. Installer does not support internationalized ICS names.

30633

When using the French locale, the sorting algorithm for alphabetizing locale names on the Language Selection Panel is inconsistent with that of other locales. Simplified Chinese appears first on the list, even though it begins with the letter "c", and German (allemand) follows it, even though it begins with the letter "a".

32212

You must provide the following values in the OptionFile.txt file:

  • If you use the Oracle database driver, provide values for all the parameters listed.
  • If you use the MS-SQL database driver, provide values for all the parameters listed except FLOW_MONITORING.
  • If you use the DB2 database driver, values for the following parameters are not required: EVENT_HOST_NAME, EVENT_MANAGEMENT_PORT, TRANSACTIONS_HOST_NAME, TRANSACTIONS_PORT, REPOSITORY_HOST_NAME, REPOSITORY_PORT, FLOW_MONITORING_HOST_NAME, FLOW_MONITORING_PORT.

When the CollaborationFoundation installer is run on a machine with a Windows XP operating system, only the license files and the uninstaller are installed. The .jar files needed for the collaboration to run are not installed.

Workaround:
  1. Install CollaborationFoundation on machine with Windows 2000 operating system.
  2. Copy the following folders from C:\IBM\ESD\CollaFoundation:
    CollaborationFoundation
    DLMs
    repository
    WBICoreCollabs
  3. Paste the copied folders in the folder C:\IBM\ESD\CollaFoundation on the Windows XP machine.

SNMP

Tracking number

Problem

8089

The SNMP Agent and SNMP Configuration Manager are installed together as a bundle, even though the Agent and the Manager can function on separate machines.

Documentation

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.

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