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.
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 are included in the product documentation. See Installation, migration, upgrade, and configuration information for links to those guides.
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.
The following limitations are found in this version of the product:
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:
Both of these problems can be addressed by following these steps:
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 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:
|
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 |
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:
|
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:
|
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