These release notes cover release information for IBM(R) WebSphere(R) Business Integration Express Plus for Item Synchronization, version 4.3.1. They 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/software/integration/wbiitemsync/express/support/. Select the component area of interest and search the flashes section.
IBM WebSphere Business Integration Express for Item Synchronization is a mid-market supplier solution that meets trading partner supply chain integration requirements for integrating product information with the GLOBALregistry of UCCnet. With UCCnet connectivity, suppliers can add or update item data from internal systems and allow those changes to occur throughout their trading network, reducing the time and costs associated with item management.
WebSphere Business Integration Express Plus for Item Synchronization is made up of these components:
New features and improvements made in this release include the following:
Between release 4.3.0 and 4.3.1, the following CRs, based on customer-reported cases, were fixed.
| Component name | Tracking Number | Description |
| InterChange Server Express | 24077 | During server boot time recovery, InterChange Server Express System Monitor incorrectly shows the state of the collaborations in transactional collaborations groups to be active, although they are actually inactive until the collaboration recovery is complete. |
| Launchpad | 27555 | When using MS SQL Server 2000, if a database named SMB_DB already exists on the database server, you must manually drop the database before proceeding with the Database Setup section in the Launchpad. |
| System Manager | 18682 | For user-created folders inside a project, System Manager returns an error when creating a collaboration object. |
| Relationship Manager | 28022 | Only one Participant instance is allowed for each Participant definition of an identity relationship; however, the Add Participant item in the context menu is enabled when it should be disabled. As a result, you can add one more than Participant instance to a Participant definition of an identify relationship, which causes an error. |
| InterChange Server Express System Monitor | 23814 | When changing the color theme of graphs (Bar, Line, Stacked Bar), you must click on the large color box choice for the colors to be set properly. Do not use the small color boxes for choosing the color theme. |
| InterChange Server Express System Monitor | 27860 | If you are running the Monitor with DBCS locales, do not change the font settings for the Line, Bar, Stacked Bar, and Meter charts. If you change the fonts for these charts, the DBCS characters will appear as squares. |
Ensure no version of the IBM WebSphere InterChange Server is installed on the system on which you plan to install WebSphere Business Integration Express, or Express Plus, for Item Synchronization.
Hardware and software requirements are listed in Installing WebSphere Business Integration Express and Express Plus for Item Synchronization.
Whether you are installing the software from the CD or downloading it from
Passport Advantage and installing it from a local directory, refer to
Installing WebSphere Business Integration Express and Express Plus for
Item Synchronization. This guide also includes configuration information.
Before starting InterChange Server for the first time (for both Express
and Express Plus versions)
After installing WebSphere Business Integration Express for Item Synchronization
on your iSeries(TM) system, you must perform the following steps before you start InterChange
Server for the first time:
Before using the Web-based System Monitor function (for both Express and
Express Plus versions)
After installing the WebSphere Business Integration Express for Item Synchronization on your iSeries, you will need to perform the following actions on the iSeries prior to using the Web-based System Monitor function. On the OS/400 command entry, do the following (Note: Case is important; enter text exactly as shown):
1) Sign on to OS/400 with a user profile that has *SECADM authority.
2) Run the QSH CL command.
3) Enter one of the following QShell commands, based on your version of
WebSphere Application Server:
For WebSphere Application Server Express, enter: /QIBM/ProdData/WebASE/ASE5/bin/GenPluginCfg
-instance ICSMonitor
For WebSphere Application Server, enter: /QIBM/ProdData/WebAS5/Base/bin/GenPluginCfg
-instance ICSMonitor
| Component name |
Tracking number |
Description |
| InterChange Server Express | 23061 | If a long-lived business process (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. |
| InterChange Server Express | 23243 | If a valid database connection is selected from the Server View, error messages are printed in the InterChange Server Express log. No feedback is given in the GUI. |
| InterChange Server Express | 23879 | If a collaboration is in an in-doubt state, InterChange Server Express System Monitor incorrectly displays the status color in red instead of yellow. |
| InterChange Server Express | 24374 | If the ItemSync collaboration is in a paused state before shutting down
InterChange Server Express, the collaboration displays as inactive after
InterChange Server Express is restarted.
To work around this, start the collaboration, then stop it and restart it again to enable recovery and to process events. |
| InterChange Server Express | 26017 | The retry feature of connector agents does not work. The RestartRetryCount
is currently set to 0 (the default) and should not be increased. To work around this, restart the agent using the Object Activation Daemon (OAD) restart feature. In the connector configuration file, set OADAutoRestartAgent to true. |
| InterChange Server Express | 26650 | You must install the WebSphere Business Integration Express for Item Synchronization product as a local administrator. |
| InterChange Server Express | 31760 | If you use the Windows operating system and you want to use the e-mail
notification support, then you must take the following steps:
|
| InterChange Server Express | 32077 | There is a known problem with retrieving connector logging and tracing
function. If your connector is started and you have retrieved your configuration
file from the repository, your log and trace file configuration settings
are ignored. If you have configured logging and tracing to be enabled,
then you need to perform the following additional steps:
|
| InterChange Server Express | 32487 | There is a known problem that produces an invalid attribute text error on Linux using JTextISoft connector with schema. The error message is " **** ERROR : Invalid attribute text, unrecognized token.********* ". To avoid this, move CwXMLDataHandler.jar in front of CwDataHandler.jar in CWSharedEnv.sh and CWConnEnv.sh |
| DB2 | 32441 | If you use Launchpad to reinstall DB2, you must first remove the previous database directories (for example, C:\DB2). Otherwise, Launchpad will be unable to execute the CREATE DATABASE command, and will fail with the message "An unexpected error occurred while attempting to create the repository database." |
| DB2 on Linux | 32442 | You have two options for configuring for DB2. Option 1 Configure DB2 using the DB2 control center as described in the following steps:
Configure DB2 using the DB2 command as outlined in the following steps:
|
| Launchpad | Before installing the DB2(R) 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. |
|
| 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. This is because the DB2 Express component creates
a user with administrative rights, causing the Welcome Screen to stop displaying
the Administrator account. To work around this, 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 | 31965 | If you are installing from the CD and Launchpad prompts you to insert the CD for WebSphere MQ or DB2, insert the CD and make sure it is mounted successfully before you choose OK. If Launchpad does not detect the installation program, it will display an "Open" dialog box, in which you must select the location to which the CD is mounted. |
| Installer | When running the uninstaller, some files may remain on the system. To work around this, remove the files manually. | |
| Installer | 11600 | Initial startup of Installer may be slow during the initialization of a Java Virtual Machine (JVM). Do not try to start Installer multiple times. |
| Installer | 26076 | The Naming Server panel should appear only if you select Toolset Express;
however, it may appear on other occasions.
To work around this, in the Naming Server panel, enter the IP address of the machine on which the ItemSync collaboration will be installed. |
| Installer | 27311, 27557
|
Silent install installs a typical setup type even if you specify a customized setup type in the Setup Type section of the settings_ItemSync_Windows.txt response file. To work around this, in the Setup Type section of settings_ItemSync_Windows.txt, clear the current setup type by using the following value: -W expressSetupTypesSelectedSetupTypeId= Then set all desired Feature section options to true and those not desired to false. Note: If you set any Adapters Feature option to true, also set the Item Sync Feature to true and include an option file. |
| Installer | 27558 | Windows services configured during second and subsequent installations are not removed from the Services Control Panel during an uninstallation.
To work around this, manually remove the service from the Windows registry and then reboot your machine so the Services Control Panel is updated. All adapter services are named CWInterchange WBIAdapterName (for example, CWInterchange WBIJTextAdapter). Also, a CWInterchange WICSExpress service is created when you install the ItemSync collaboration. To remove any of these services, make sure the service is set to manual execution in the Service Control panel and is not started. Use regedit to go to the registry editor. Expand HKEY_LOCAL_MACHINE, SYSTEM, CurrentControlSet, and Services. Remove the folder entries for adapter and InterChange Server Express as needed. Adapter services are named CwWBIAdapterName (for example, CwWBIJTextAdapter). InterChange Server Express is named CwWICSExpress. |
| Installer | 27714 |
The system environment variable MQ_LIB may be set to the incorrect value
\java\lib for the WebSphere MQ Java library location. It should be set
to C:\Program Files\IBM\WebSphere MQ\Java\lib. |
| Installer | For both Express and Express Plus If your iSeries system had WebSphere Application Server Express (5722IWE) loaded and you removed it, the WebSphere Business Integration Express for Item Synchronization installation application will configure the Web-based system monitor for WebSphere Application Server Express. If you have WebSphere Application Server (5733WS5) installed on the iSeries, you will need to manually configure your iSeries for the Web-based system monitor to work. Perform the following (note: the following is case-sensitive):
|
|
| Installer | If you notice in the "Viewing Delivered Components" section of
the Quick Start Guide that there are no components in your ItemSyncLibrary and you did a tools only installation on your Windows client using the Windows install CD, you will need to do the following in order for these components to be placed in your ItemSyncLibrary:
|
|
| Installer | For both Express and Express Plus If you install additional adapters on the iSeries after a previous install, the owner of the new directories and subdirectories for the newly installed adapters (/QIBM/UserData/WebBIICS/connectors/) and Object Discovery Agents (/QIBM/UserData/WebBIICS/ODA directory) will be the installer's user profile. You should change this to the QWEBBIICS user profile using the CHGOWN CL command. For example, CHGOWN OBJ('/QIBM/UserData/WebBIICS/connectors/WebServices') NEWOWN(QWEBBIICS) RVKOLDAUT(*YES) This will set the owner of the WebServices directory to the QWEBBIICS user profile. This should be done for all of the directories and subdirectories for the adapters that you installed. |
|
| Installer | For the Express Plus version After you install the WebSphere Business Integration Express Plus for Item Synchronization on your iSeries system, the owner of the subdirectories in the /QIBM/UserData/WebBIICS/ directory will be the installer's user profile. Ownership of these subdirectories should be changed to the QWEBBIICS user profile using the CHGOWN CL command [for example, CHGOWN OBJ('/QIBM/UserData/WebBIICS/connectors/') NEWOWN(QWEBBIICS) RVKOLDAUT(*YES)]. This will set the owner of the connectors directory to the QWEBBIICS user profile. This should be done for all of the subdirectories in the /QIBM/UserData/WebBIICS directory. |
|
| Toolset Express | 18981 | Connector Configurator, Business Object Designer
Express, Map Designer Express, and Relationship Designer Express show deleted projects
in their project lists.
To work around this, close all designer tools before deleting a project from System Manager. |
| Connector Configurator Express | You cannot create multiple values of a connector-specific property in the Connector-Specific Properties category. You must use the Connector-Specific Property Template wizard to create multiple values of a connector-specific property. | |
| InterChange Server Express System Monitor | 27860 | If no adapters are installed, clicking the Connector View in the Monitor causes an error. |
| Integrated Test Environment | The ITE console menu now color-codes the text depending on the message type: normal text is black, warnings are blue, and error messages are red. | |
| All adapters | 27452 | When executing the start script for any adapter, the error "Input
line too long" might be returned and the adapter will not start. The
problem is that the command line to start the adapter is too long. To avoid this problem, shorten the start script command to invoke the adapter by removing unnecessary or duplicate .jar files or DLLs from the start script's class path. |
| Adapter for JDBC | 23147 |
Using CLOB data types is restricted to retrieve operations because of restrictions in different JDBC drivers on writing CLOB data to the database. |
| Adapter for JDBC | 26896 | An error occurs when executing event_package_db2.sql (a JDBC adapter dependency file). To compile this SQL script, first copy its contents and paste it in Development Center under DB2 Express, and then compile. |
| Adapter for JDBC | 27326 | The error "Input line too long" might be returned when you execute the start script. If this error is returned, remove all drivers you are not using from the JDBCDRIVERPATH and DATADIRECT variables in the start script. |
| Adapter for JMS | 27717 | The samples for this adapter are incompatible with Toolset Express. The JMSConnector.cfg file in the samples subdirectory may not be loaded properly into Connector Configurator. |
| Adapter for Web Services | 23993 | When the Web Services Description Language (WSDL) ODA encounters multiple inline schemas that import each other without providing schema locations, it logs warnings or errors; however, the business objects are generated properly. |
| Adapter for Web Services | 24662 | When WebSphere MQ 5.3 CSD03 is used as the JMS provider, the adapter's JMS listener cannot read message bodies after moving the message from the input to the in-progress queue. This is a problem with the WebSphere MQ application. |
| All Adapters | 32076 | There is a known problem with the use of encrypted connector properties.
If your configuration contains connector specific properties that are encrypted
and you wish to use IDL as your transport mechanism, you will need to perform
the following steps:
|
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 Express for Item Synchronization InfoCenter. The following documents can be found on that Web site:
Quick Start Guide
User Guide
Installing WebSphere Business Integration Express and Express Plus for Item Synchronization
Business Object Development Guide
Map Development Guide
Data Handler Guide
Collaboration Development Guide
Solution Development Guide
Item Synchronization Collaboration
Generic Business Objects
Adapter for e-Mail User Guide
Adapter for iSoft Peer-to-Peer Agent User Guide
Adapter for JDBC User Guide
Adapter for JMS User Guide
Adapter for JText User Guide
Adapter for mySAP.com User Guide
Adapter for WebSphere MQ User Guide
Adapter for Web Services User Guide
Adapter for XML User Guide