Release Notes for IBM WebSphere Business Integration Server Express, Version 4.3.0

These release notes contain the following sections:

Overview Limitations
Hardware and software requirements Known problems and workarounds
Installation and configuration information 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.


Overview

The products IBM WebSphere Business Integration Server Express and IBM WebSphere Business Integration Server Express Plus are made up of the following components:

The tools in the Toolset Express help you to create, modify, and manage business processes. You can choose from among the prepackaged adapters for your business processes that span applications. The standard processes template - CollaborationFoundation - allows you to quickly create customized processes.


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 and configuration information

Web services support: Web services support in the server is not enabled by default. If you must invoke web services from the server, start the server manually (not using the InterChange Server shortcut from the Start > Programs menu): Navigate to the ProductDir\bin folder and run the start_server_webservice.bat file with the usual command-line parameters.

Whether you are installing the software from the CD or downloading it from Passport Advantage and installing it from a local directory, refer to WebSphere Business Integration Server Express Installation Guide.


Limitations

The following limitations are found in this version of the product:


Known problems and workarounds

The following problems have been found in this release:

Component name Tracking number Description
DB2 Enterprise 35380 DB2 Enterprise does not restart the database manager when Windows restarts. Because the database manager is not running, two problems can occur if Windows restarts during the installation of WebSphere Business Integration Server Express or Express Plus:
  • Repository creation can fail. When repository creation fails because of this issue, the Installer log includes the following message line: "No start database manager command was issued."
  • Startup of InterChange Server Express can fail, because without the DB manager running, InterChange Server Express cannot connect to SMB_DB. When this failure occurs, the InterchangeSystem log file messages include this line: "No start database manager command was issued."

Both of these problems can be addressed by following these steps:

  1. Open DB2 Control Center.
  2. Expand the All Cataloged Systems folder, then expand the folder for your host, and then expand the Instances folder.
  3. In the Instances folder, right-click the DB2 icon and choose Start.
    This DB2 message displays: "DB2START processing was successful."

After you have performed these steps, you can create a repository and successfully start InterChange Server Express.

DB2 Enterprise and DB2 Express uninstallers 35380 Repository creation fails during reinstallation of WebSphere Business Integration Server Express or Express Plus if DB2 Enterprise or DB2 Express and WebSphere Business Integration Server Express or Express Plus have been installed and uninstalled previously. The uninstallation process for DB2 Enterprise and DB2 Express does not remove aliases for databases from the directory C:\DB2\aliases_directory. So the alias for the InterChange Server Express repository called SMB_DB, which is created during the original installation of WebSphere Business Integration Server Express or Express Plus, remains after the uninstallation of DB2. Existence of this alias does not affect reinstallation of DB2 Enterprise or DB2 Express. However, when WebSphere Business Integration Server Express or Express Plus is reinstalled, repository creation fails because the system finds the old SMB_DB alias.

Workaround: Manually delete the SMB_DB database before uninstalling and reinstalling DB2 Enterprise or DB2 Express. Deleting the actual database eliminates its alias.

Installers (All except Collaboration Capacity Pack) 36144 Adapter-related files and Object Discovery Agent-related files can be installed only with permissions set to read-only.

Workaround: After installation, change the permissions on these files.

Launchpad Before installing the DB2 Express or WebSphere MQ component, you must disable any real-time file-system protection features of installed antivirus software.

If you have Norton AntiVirus software installed, you can disable its real-time file-system protection feature by stopping the "Norton AntiVirus Client" Windows service. For other antivirus products, refer to the product's documentation for instructions on how to disable the real-time file-system protection feature. You can enable this software after the product has been installed.

Launchpad 27110 If you are installing on a Windows XP machine and the Windows XP welcome screen is enabled, you cannot log in as administrator after installing the DB2 Express component. The DB2 Express component creates a user with administrative rights, which causes the welcome screen to stop displaying the administrator account.

Workaround: Disable the welcome screen. Go to Start > Control Panel > User Accounts > Change the way users log on or off. Clear the Use the Welcome screen box, then click Apply Options. To log in as the DB2 administrator if you are locked out, you can log in with the user ID db2admin and the password smbP4$$word.

Launchpad 27198 Sometimes when installing the Java 1.3.1 component from the Launchpad, you are prompted to insert javaw.exe into your CD-ROM drive. You can ignore this message. Click Continue.
Launchpad 35851 Installation of DB2 Express or WebSphere MQ 5.3.0.2 with CSD 5 may fail when installed using the electronic image, if the images are downloaded to a location with spaces.

Workaround: Extract electronic images to a location that does not contain spaces.

Tools - Activity Editor 36145 The color marking in the Java code editor in the Activity Editor cannot handle quotation marks within strings. However, this should not affect compilation.
All adapters 33705 setdoubleValue must handle fractions independently of the locale setting. Two new properties - MaxDoublePrecision and MaxFloatPrecision - have been introduced to fix this problem. Their values are used to set the maximum digits for number formatting before setting the value with the setAttrValue in the setdoubleValue and setfloatValue methods of the WebSphere Business Integration Adapters application-programming interface. Fixed in fix pack 1.6.1 of the WebSphere Business Integration Adapters application-programming interface.
Adapter for e-Mail 35896 When trying to start the Adapter for e-Mail (start_EMail.bat), the following error is returned:
C:\IBM\WebSphereServer\connectors\EMail>REM start the Java connector under the Java Application End
The input line is too long.
The syntax of the command is incorrect.

Workaround: In the files \connectors\Email\start_Email.bat and start_Email_service.bat, remove %DataHandler_JAR% from the following line: set JCLASSES=.;%JCLASSES%;%JAVA_MAIL%;%XML_PARSER%;%DataHandler_JAR%;

Adapter for iSeries 32570 The program call was being executed twice. The duplicate call to run the RPG program has been removed. Fixed in fix pack 1.1.1 of the adapter.
Adapter for JMS and Adapter for WebSphere MQ 33728 During event processing, when multiple conversion properties match the InputFormat, InputQueue, or both of an input message, the adapter tries to incorrectly use the last matched business object attribute in the static meta-object as a map for the input message. In such cases, the adapter should pass the message content to the data handler to allow the data handler to determine the business object name.

Workaround: Configure unique InputFormat and InputQueue keys for each of the BusinessObjectType_verb attributes in the static meta-object.

Adapter for JMS and Adapter for WebSphere MQ 34323 The samples for the adapters for JMS and WebSphere MQ are designed for a stand-alone configuration using one of the WebSphere message brokers. Therefore, they do not demonstrate the configuration and use of the adapters in a WebSphere InterChange Server Express environment. However, the business objects in the samples subdirectory can be viewed using the Business Object Designer Express and can be imported to the WebSphere Business Integration Server Express projects using the System Manager tool. These objects provide a sample configuration of the meta-objects and business objects that can be used with the adapters.
Adapter for JDBC and Adapter for Oracle Applications 29985 When retrieving output parameters after a stored procedure call, the getString method was used to get parameters for all types (int, date, and so on). With the new JDBC driver for DB2 8.1, getString returned an SQL exception. This was fixed using the appropriate call for each type (getInt, getDate, and so on). Fixed in JDBC fix pack 2.4.3.
Adapter for JDBC and Adapter for Oracle Applications 30523 If one input parameter for setPrimaryKeys was set to CxIgnore, the adapter was not setting values for the rest. Fixed in fix pack 2.4.3 of the adapters.
Adapter for JDBC and Adapter for Oracle Applications 30598 The error message for a DeltaUpdate operation on an invalid verb was missing. Fixed in fix pack 2.4.3 of the adapters.
Adapter for JDBC and Adapter for Oracle Applications

31301

When retrieving a result set returned by a stored procedure, the adapter flags the following error: Attribute RS not found. The output attribute name is retrieved after the adapter checks that the attribute name is RS. The attribute name is now retrieved before the check, so that OP=RS is handled appropriately. Fixed in fix pack 2.4.3 of the adapters.

Adapter for JDBC and Adapter for Oracle Applications 31759 E-mail messages are not sent when a collaboration has failed and e-mail notification is set up. Fixed in fix pack 2.4.3 of the adapters.
Adapter for JDBC and Adapter for Oracle Applications 32620 A failure occurs when updating a child business object with an integer key value that has leading zero. When the retrieved business object and business object to be updated are compared, the string values of all key attributes were being compared, so leading zeros resulted in a failure of the comparison. Now the string value is first converted to the appropriate type and then compared, so that the problem is resolved. Fixed in fix pack 2.4.3 of the adapters.
Adapter for JDBC and Adapter for Oracle Applications 33052 A FAIL status is not returned on a delete operation with an integrity constraint. The status flag is not reset to fail after a retrieve operation before a delete operation. The status has been reset to fail before the delete operation. Fixed in fix pack 2.4.3 of the adapters.
Adapter for JDBC and Adapter for Oracle Applications

33394

When determining the type of the event_id field, the EVENT_ID column was hardcoded and caused failure for dynamic queries. Fixed in fix pack 2.4.3 of the adapters.
Adapter for JDBC and Adapter for Oracle Applications 33565 When setting foreign keys on a parent business object, if one of the single-cardinality child business objects was missing, the foreign keys for all preceding single-cardinality child business objects were being overwritten by CxIgnore. This has been fixed (in fix pack 2.4.3 ) to populate the foreign keys appropriately.
Adapter for JDBC and Adapter for Oracle Applications 34025 The ReturnStatusDescriptor is populated with the wrong error message for a retrieve operation failure. The error message indicates that the child object does not exist in the database. However, the problem is that the parent object does not exist in the database. Fixed in fix pack 2.4.3 of the adapters.
Adapter for JDBC and Adapter for Oracle Applications 34612

During polling, multiple commits to the database update the status of events in the event and archive tables as soon as possible. This is required because some users filter events in the event table based on status. However, this can cause performance problems. Fixed in fix pack 2.4.3 of the adapters.

The solution makes the multiple commits configurable. A new connector specific property - SelectiveCommitForPoll - has been introduced. If its value is true, then there is only one commit - after an event has been processed. If its value is false, then the behavior is the same as before - commits to the database are done at each stage of event processing. The default value for the property is false.

Adapter for PeopleSoft 33509

Child update operations fail when they are sent along with new child create operations as part of an Update operation. This has been resolved. Now, the item count is obtained every time before updating or creating a child instance. Fixed in fix pack 2.3.2 of the adapter.

Adapter for PeopleSoft 25445

The application password value is not encrypted in the trace file, even though the property is encrypted. This has been resolved. Because all connector configuration properties are traced before entering the connector agent code, the second tracing of properties that do not undergo changes is removed. Fixed in fix pack 2.3.2 of the adapter.

Adapter for PeopleSoft 32244 The EventNotificationInstall.exe file was corrupt. Fixed in fix pack 2.3.2 of the adapter:
  • The self-extract capability has been restored.
  • When the file extracts, two folders are created, CW_EVENT_V150 and CW_EVENT_V140, in the %CROSSWORLDS%\connectors\PeopleSoft\Dependencies\Projects directory. CW_EVENT_V140 is for PeopleTools 8.1x and the CW_EVENT_V150 is for PeopleTools 8.4x.
  • For the CW_EVENT_V140 project, PeopleCode had been modified to include Modes U, L, and C. These modes are represented by the Update verb.
Adapter for Siebel eBusiness Applications 29378 SiebelODA had a problem generating integration objects and components in older versions of the Siebel Application (6.2). Fixed in fix pack 4.4.2 of the adapter.
Adapter for Siebel eBusiness Applications 30184 Support has been added for retrieval of multiple records with the RetrieveByContent verb. Fixed in fix pack 4.4.2 of the adapter.
Adapter for Siebel eBusiness Applications 30307 After an update operation, the adapter is not dumping the business object, even when the update operation is successful. Fixed in fix pack 4.4.2 of the adapter.
Adapter for Siebel eBusiness Applications 30731 Creation of child and grandchild integration objects was not working properly when multiple instances of the objects were specified. Fixed in fix pack 4.4.2 of the adapter.
Adapter for Siebel eBusiness Applications 33305 Even after the adapter stops, some connections continue until their session timeout; they should be terminated when the adapter stops. Fixed in fix pack 4.4.2 of the adapter.
Adapter for Siebel eBusiness Applications 33368 The adapter does not restart, even if the RestartRetryCount and RestartRetryInterval standard properties are set. Fixed in fix pack 4.4.2 of the adapter.
Adapter for Siebel eBusiness Applications 33632

SiebelODA converts the Siebel data type DYE_NUMBER to Integer instead of Float. This has been fixed. Note: The adapter treats all data as String data type, so it does not use the data types converted by the ODA. Fixed in fix pack 4.4.2 of the adapter.

Adapter for Siebel eBusiness Applications 34891 The adapter, when used against Siebel 6.x Financials, is crashing after 1400 poll calls. In the lifetime of the adapter, a single/reserved data bean is used for polling. In Siebel 6.x applications, resources are not released properly and are piling up. After some time, the adapter fails. Fixed in fix pack 4.4.2 of the adapter. The adapter now refreshes the polling bean after the bean has been used for the number of times specified in DatabeanRefreshInterval.
Adapter for Siebel eBusiness Applications 35131

SiebelODA sets the application-specific information in a wrapper business object definition as ObjectName= <object name>, instead of ON=<object name>, where <object name> is the name of the Siebel business object. Fixed in fix pack 4.4.2 of the adapter.

Adapter for WebSphere Commerce and Adapter Capacity Pack Installer 42464 The target location in the WebSphere Commerce shortcut is incorrect; starting the adapter from the shortcut does not start the adapter.

Workaround: Modify the target to ProductDir\connectors\WebSphereCommerce\start_WebSphereCommerce.bat WebSphereCommerce WebSphereICS

Example: C:\IBM\WebSphereServer\connectors\WebSphereCommerce\start_WebSphereCommerce.bat WebSphereCommerce WebSphereICS

Adapter for WebSphere MQ 30873 While processing synchronous events, the adapter does not close the handle to the replyToQueue. Fixed in patch 2.5.1.
XML Data Handler 31537 The data handler is not backward-compatible with business object definitions generated using an older version (before 2.4.0) of XML ODA.

Workaround: If possible, regenerate the business object definitions using the latest version of XML ODA included in patch 2.5.2.

XML Data Handler 32710 The xml:lang attribute in the business object is not being populated.

Workaround: Manually change the application-specific information for the attribute representing xml:lang in the business object definition to attr_name=lang;type=attribute;attr_ns=http://www.w3.org/XML/1998/namespace.

XML Data Handler 33007 The data handler failed to create business objects from XML documents in a multi-threaded environment. Fixed in patch 2.5.1.
XML Data Handler 34625 The data handler failed to populate business objects when the IgnoreUndefinedAttributes property was set to true. Fixed in patch 2.5.2.
XML Data Handler 34855 XML ODA failed to create business object definitions in some cases when the ODA property typeSubstitution was set to true. Fixed in patch 2.5.2.
XML Data Handler 35055 The data handler had backward-compatibility with the new-line character. Fixed in patch 2.5.2.
Documentation Data Handler Guide: The guide incorrectly refers to and provides documentation for the Binary Host Data Handler. The Binary Host Data Handler is not included in the product.
Documentation 35371 System Administration Guide: In Chapter 3, "Troubleshooting the system," an incorrect value is listed for an example in the "Steps for customizing the Object Request Broker" procedure. The Dcom.ibm.CORBA.Debug.Output value should be "nul" with one "l."

The first bulleted item of the example after step 4 should read as follows:

Add the IBM ORB property to the ORB_PROPERTY variable in the CWSharedEnv file: ORB_PROPERTY=-DORBNamingProvider=CosNaming
-Dorg.omg.CORBA.ORBClass=com.ibm.CORBA.iiop.ORB
-Dorg.omg.CORBA.ORBInitialPort=%ORB_PORT%
-Dorg.omg.CORBA.ORBInitialHost=%ORB_HOST%
-Dcom.ibm.CORBA.Debug.Output=nul
-Dcom.ibm.CORBA.ThreadPool.MaximumSize=100
Documentation 36055 WebSphere Business Integration Server Express Installation Guide: In the section "Configuring System Monitor and Failed Event Manager to use a different port number," the URLs listed in Steps 4 and 5 are incorrect:
  • In step 4, the URL should be http://hostname:portnumber/ICSMonitor.
  • In step 5, the URL should be http://hostname:portnumber/FailedEvents.
Documentation 42461 WebSphere Business Integration Server Express Installation Guide: In the section "Starting WebSphere Business Integration Server Express or Express Plus," in the first bulleted item in step 1, the name of the file should be InterChangeSystem.log.
Documentation 42447 WebSphere Business Integration Server Express Installation Guide: In the section "Installing the Java compiler," a status value in the Note appended to step 2 is incorrect. When you select the "I do not plan to compile collaborations or maps" check box, the JDK status changes to "Optional" rather than "OK," as documented. Therefore, the final sentence of the Note should read as follows: "The software status immediately changes to Optional."
Documentation 42449 WebSphere Business Integration Server Express Installation Guide: In the section "Configuring an existing installation of IBM DB2 Universal Database v8.1 Express or Enterprise," the procedure for database setup is incorrect. You do not have to perform steps 2a, 2b, or 3.
Documentation 42450 The README_SystemTest_Sample.rtf file is obsolete. For information about the System Test Sample, see the Quick Start Guide.
Documentation 42471 WebSphere Business Integration Server Express Installation Guide: The text in two areas of this guide states that only Toolset Express is supported on the Windows XP operating system. Actually, InterChange Server Express is also supported on this operating system when it is run with the Integrated Test Environment in nonproduction environments. The two areas are in the following sections:
  • "Installing WebSphere Business Integration Server Express and Express Plus using the GUI," in the third bulleted item in the list of assumptions.
  • "Checking software requirements" in Table 4.


Documentation

Product documentation is not included as part of the product package, either by CD or electronic product distribution. The documentation for this product can be found in the IBM WebSphere Business Integration Server Express InfoCenter.

The following documents can be found on that Web site:

Map Development Guide
Business Object Development Guide
Collaboration Development Guide
Data Handler Guide
WebSphere Business Integration Server Express Installation Guide
Quick Start Guide
System Implementation Guide
System Administration Guide
Adapter for COM User Guide
Adapter for e-Mail User Guide
Adapter for Exchange User Guide
Adapter for iSeries User Guide
Adapter for JD Edwards OneWorld User Guide
Adapter for JDBC User Guide
Adapter for JMS User Guide
Adapter for Lotus Domino User Guide
Adapter for MetaSolv Applications User Guide
Adapter for mySAP.com (SAP R/3 V. 4.x) User Guide
Adapter for Oracle Applications User Guide
Adapter for PeopleSoft User Guide
Adapter for Portal Infranet User Guide
Adapter for Siebel eBusiness Applications User Guide
Adapter for SWIFT User Guide
Adapter for Telcordia User Guide
Adapter for Web Services User Guide
Adapter for WebSphere Commerce User Guide
Adapter for WebSphere MQ User Guide
Adapter for XML User Guide

Collaborations for Customer Relationship Management
Collaborations for Procurement
Collaborations for Financials and Human Resources
Collaborations for Order Management

Copyright IBM Corp. 2004