Fix Pack Notes for
WebSphere Business Integration (WBI) Toolset version 4.2.1.4

The patch notes contain the following sections: 
 
COMPLETED CHANGE REQUESTS

UPGRADE INSTRUCTIONS

ADDITIONAL DISCUSSION

UNINSTALL INSTRUCTIONS

COMPLETED CHANGE REQUESTS

This patch contains fixes for the following CRs based on customer reported and internally discovered issues.
 
CR Number
As of Version
Problem
29111
4.2.1.4
Activity Editor: 
In a graphical activity, if a constant is declared to contain space characters " " only, then the generated Java code will trim the text and initalize the constant to null instead of the space characters.
Fixed code generation in order to prevent  trimming the value specified in activity constants.  The activity constant can now be initalized to space characters " ".
28699
4.2.1.4
Connector Designer: 
Customers ran into a problem where once-supported business objects and maps are not getting removed from the connector definition.  Therefore, dependency errors were thrown when trying to validate the project. 
After applying this fix, the customers will be able to delete selected business objects.  When the connector configuration file is re-saved, maps associated with the deleted business objects will be removed from the configuration file automatically.  The updated configuration file will pass when validation is checked and/or when the configuration is deployed.
26433
4.2.1.4
Activity Editor: 
In Activity Editor, when the "condition" function block is used, the initalization and assignment of port variables are put outside the condition scoop, which creates a problem for using temporary variable for port variables.
Fixed code generation to put the initalization and assignment of port variables in the scoop of the condition statement. (i.e.  inside the "if(..){...} else {...} constructs).
27849
4.2.1.3
Business Object Designer: 
For some BO projects with complex inter-dependencies, the BO Designer crashed when saving high level BOs. In particular, the BO Designer crashed when it was either not modified or had a modified sub-BO very low in the project hierarchy. The fixed consisted in replacing a recursive traversal of modified BOs with a linear stack traversal.
27504
4.2.1.3
Business Object Designer: 
An incorrect namespace of application specific information in the structure of BO schemas prevented the application specific information to be deployed to the server.  The namespace has been modified to make the deployment succeeded.
27091
4.2.1.3
Process Designer: 
In Process Designer for a collaboration template, the user cannot uncheck a 
compensation service call and have it stay that way.  If the user unchecks it, 
clicks "Apply", then closes, it is still unchecked when the user goes back in to the 
service call properties.  If the user saves the template, closes Process 
Designer, and opens it back up, the compensation service call is checked 
again. 
Fixed the bug by making sure that Process Designer is saving the modified service call properties properly.
25953
4.2.1.3
Business Object Designer: 
An error in the structure of BO schemas prevented them from successful deployment to the server. In particular, this created inconsistencies in the application specific information of BOs. The error was fixed and BOs should work as expected.
25121
4.2.1.2
Map Designer :
In a map that was created in release 3.1.2, in some cases, the "Set Value" transformation rule will not upgrade properly to 4.2.x versions.  This problem occurrs when the map is defined in 3.1.2 release, if the transformation rule is originally defined as "Move", "Join", "Split" or "Submap", then without deleting the transformation rule, define a "Set Value" transformation rule on top of the existing transformation rule.   In this case, the map is not associating the new "Set value" transformation rule with the destination attribute.  So after the map is upgraded to 4.2.x versions, the map shows the transformation rule as the original type (i.e. Move) instead of "Set Value" type, and when map is recompiled, it will generate code that will transform as the original rule does (i.e. code for "Move" is generated).

Fixing notes:
Since the problem was with the original 3.1.2 map in that the map itself did not save the "Set Value" information correctly, the workaround for this problem is provided as follows:
With this patch, if the problem is detected in maps, the following section can be added to the file "cwtools.cfg" in the WBI tools installation directory at  "<InstallationDirectory>\bin":

    [MapsUpgrade]
    AutoUpgradeOperations=no

After adding these two lines to the end of the "cwtools.cfg" file, when the maps are imported from ICS server for upgrade, ALL map transformation rules will be modified to be user-customized -- this will make the map to compile with the java code fragments that was generated in 3.1.2, thus allowing the "Set Value" and all other transformation rules work the same as in release 3.1.2.

WARNING:  with the flag " AutoUpgradeOperations" set to "no", upgrade for all the maps will be affected.  This means that the upgraded map will always use the Java code fragment that was generated with the map when the transformation rule is created and that these java code for the transformation rules will not be automatically upgraded in future releases.  Please use this setting with care.

24775 (a.k.a. 24783)
4.2.1.2
Activity Editor:
When an activity is saved, if the scrollbar is not at the original position, then the activity node's position is not saved properly, and so when the activity is reopened, the node may not be shown in the canvas.

Fixing notes:
Activity Editor is fixed to save the node's position with regard to the scroll position.  Also, node location checking is added --  when an activity is opened, Activity Editor will check to make sure that no object should be located outside of scrollable areas.  If any object is located outside of the viewable area (as is possible if the activity is created before this CR is fixed), then activity editor will adjust the node's position to display it at the nearest viewable location. 
Related to this is that "paste" of nodes in the activity canvas is also fixed.   Nodes will be pasted within the scrolled display area.  If the cursor is within the display area, nodes will be pasted at the cursor's location.  Otherwise, if the cursor is not currently in the display area, objects will be pasted beginning at the upper left corner of the current display area.

24568
4.2.1.2
SNMP: 
The SNMP Agent was causing memory leak for the WebSphere InterChange Server and itself. 
The fixing makes sure that there would not be any infinite growth in memory usage.
22935
4.2.1.1
System Manager : 
The System Manager was crashing by going out of available Memory 
a) When the user tries to delete a component from a project, 
b) When the user tries to deploy a large Repository to the Server. 
c) When the user tries to export a large Repository to a Repository Jar file. 
d) When the user tries to find the references or dependencies of a particular component by  right-clicking a component and choosing "Show dependencies", "Show References".. 
Fixing notes: 
The fix has been tested with projects imported from Repository Jar files of up to 9MB size.  In case the customer has a bigger repository, it may be needed to be deployed as two packages instead of a single package. 
In case the deployment to an active server fails, the customer can export the project to a Repository file(*.jar files) and then repos copy "in" the jar file using the "Repos_Copy" command line utility.
24880
4.2.1.1
Business Object Designer:
Business Object Designer did not adapt any App Spec Info of some business object with a length greater than 225 characters.

Fixing notes:
Business Object Designer expands the App Spec Info length to 4000 characters.

UPGRADE INSTRUCTIONS 

Before applying this patch, it is highly recommended that  you backup the $CROSSWORLDS/bin, $CROSSWORLDS/lib, $CROSSWORLDS/WBSM and $WSWB_PATH/plugins folders (e.g.  C:\IBM\WebSphereICS\Tools\WSWB203\plugins).  In the case you want to uninstall the patch, replace those folders with the backups.

To perform an upgrade to this version of the WBI Toolset, please follow instructions in the correct order as follows:

  1. Make sure that you have InterChange Server  and Toolset version 4.2.1  installed.
  2. Updated to the InterChange Server 4.2.1.4 patch.
  3. Run the attached exe file (e.g. 4214_toolset_patch.exe).   Please notice that in the second step of the installing wizard, by default the installer enters the value of variable $CROSSWORLDS as an installing directory name.  If you installed WBI ICS and Toolset version 4.2.1 at another location, use the Browse button to select the correct location.  The installer will do all installing work for you. 
Note that the path name "C:\IBM\WebSphereICS"assumes that IBM WebSphere Business Integration Toolset has been installed under an IBM WebSphere InterChange Server directory on the C drive. 

Below are a list of files that need to be replaced in this patch:
 
For WICS Version
Platform [Windows]
Add / Replace / Remove
File (Starting from ~/IBM/WebSphereICS/
4.2.1.4
Windows 2000 Replace
bin/BusObjDesigner.exe
4.2.1.4 Windows 2000 Replace bin/ConnDesigner.exe
4.2.1.4 Windows 2000 Replace bin/FlowManager.exe
4.2.1.4 Windows 2000 Replace bin/LogViewer.exe
4.2.1.4 Windows 2000 Replace bin/MapDesigner.exe
4.2.1.4 Windows 2000 Replace bin/MapToXML.exe
4.2.1.4 Windows 2000 Replace bin/DiagToXML.exe
4.2.1.4 Windows 2000 Replace bin/ProcessDesigner.exe
4.2.1.4 Windows 2000 Replace bin/RelationshipDesigner.exe
4.2.1.4 Windows 2000 Replace bin/RelationshipManager.exe
4.2.1.4 Windows 2000 Replace bin/Monitor.exe
4.2.1.4 Windows 2000 Replace bin/Castor.exe
4.2.1.4
Windows 2000 Replace
bin/enu_usa/BusObjDesignerRes.dll
4.2.1.4
Windows 2000 Replace
bin/chs_chn/BusObjDesignerRes.dll
4.2.1.4 Windows 2000 Replace bin/fra_fra/BusObjDesignerRes.dll
4.2.1.4 Windows 2000 Replace bin/jpn_jpn/BusObjDesignerRes.dll
4.2.1.4 Windows 2000 Replace bin/cht_twn/BusObjDesignerRes.dll
4.2.1.4 Windows 2000 Replace bin/ita_ita/BusObjDesignerRes.dll
4.2.1.4 Windows 2000 Replace bin/deu_deu/BusObjDesignerRes.dll
4.2.1.4 Windows 2000 Replace bin/esn_esp/BusObjDesignerRes.dll
4.2.1.4 Windows 2000 Replace bin/ptb_bra/BusObjDesignerRes.dll
4.2.1.4 Windows 2000 Replace bin/kor_kor/BusObjDesignerRes.dll
4.2.1.4
Windows 2000 Replace
bin/CxCommon2.dll
4.2.1.4
Windows 2000 Replace
bin/SvrIFace2.dll
4.2.1.4 Windows 2000 Replace bin/CxCommon.dll
4.2.1.4 Windows 2000 Replace bin/SvrIFace.dll
4.2.1.4
Windows 2000 Replace
bin/Utils.dll
4.2.1.4 Windows 2000 Replace bin/Utils411.dll
4.2.1.4
Windows 2000 Replace
bin/XRmi.dll
4.2.1.4 Windows 2000 Replace bin/ActivityEditor.dll
4.2.1.4 Windows 2000 Replace bin/ServerConnection.dll
4.2.1.4 Windows 2000 Replace lib/datamanager.jar
4.2.1.4 Windows 2000 Replace lib/xrmi.jar
4.2.1.4 Windows 2000 Replace lib/cwsnmpagent.jar
4.2.1.4 Windows 2000 Replace bin/cwconverter/cwconverter.jar
4.2.1.4 Windows 2000 Replace bin/cwconverter/cwconverter.bat
4.2.1.4 Windows 2000 Replace bin/cwconverter/com.ibm.btools.itools.cwconverter/xsls/CWM4_42/CWM4_42.xsl
4.2.1.4 Windows 2000 Replace WBSM/CWDashboard.war
4.2.1.4
Windows 2000 Replace
plugins/com.ibm.btools.csm
4.2.1.4
Windows 2000 Replace
plugins/com.ibm.btools.ics.tools
4.2.1.4 Windows 2000 Replace plugins/com.ibm.btools.itools.codeGen
4.2.1.4
Windows 2000 Replace
plugins/com.ibm.btools.itools.cwconverter
4.2.1.4
Windows 2000 Replace
plugins/com.ibm.btools.itools.datamanager

ADDITIONAL DISCUSSION




UNINSTALL INSTRUCTIONS

In part UPGRADE INSTRUCTIONS, you are recommended to backup the $CROSSWORLDS/bin, $CROSSWORLDS/lib, $CROSSWORLDS/WBSM and $WSWB_PATH/plugins folders for the purpose of uninstalling the patch.
If you have done the backup process, uninstall the patch by manually replacing the folders with the back-ups.

 

© 2003 IBM Corporation.  Proprietary and Confidential.  All Rights Reserved.