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

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
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, and $CROSSWORLDS/plugins folders .  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:

1. Make sure that you have InterChange Server  version 4.2.1  installed and updated to the InterChange Server 4.2.1.1 patch.
2. Make sure that you have Toolset  version 4.2.1  installed.
3. Extract all files inside the attached ZIP file into their correct folders in your ICS installation (e.g. bin, lib, plugins are subfolders of C:\IBM\WebSphereICS).  Overwrite all files during extraction. 
4. Go to the plugins directory (e.g. C:\IBM\WebSphereICS\plugins).
5. Unzip the four zip files: com.ibm.btools.csm.zip,  com.ibm.btools.ics.tools.zip, com.ibm.btools.itools.cwconverter.zip, com.ibm.btools.itools.datamanager.zip, to the Tools plugins directory (e.g. C:\IBM\WebSphereICS\Tools\WSWB203\plugins),  overwrite all files during unzipping.

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.2	Windows 2000	Replace	bin/BusObjDesigner.exe
4.2.1.2	Windows 2000	Replace	bin/ConnDesigner.exe
4.2.1.2	Windows 2000	Replace	bin/FlowManager.exe
4.2.1.2	Windows 2000	Replace	bin/LogViewer.exe
4.2.1.2	Windows 2000	Replace	bin/MapDesigner.exe
4.2.1.2	Windows 2000	Replace	bin/MapToXML.exe
4.2.1.2	Windows 2000	Replace	bin/DiagToXML.exe
4.2.1.2	Windows 2000	Replace	bin/ProcessDesigner.exe
4.2.1.2	Windows 2000	Replace	bin/RelationshipDesigner.exe
4.2.1.2	Windows 2000	Replace	bin/RelationshipManager.exe
4.2.1.2	Windows 2000	Replace	bin/Monitor.exe
4.2.1.2	Windows 2000	Replace	bin/Castor.exe
4.2.1.2	Windows 2000	Replace	bin/enu_usa/BusObjDesignerRes.dll
4.2.1.2	Windows 2000	Replace	bin/chs_chn/BusObjDesignerRes.dll
4.2.1.2	Windows 2000	Replace	bin/fra_fra/BusObjDesignerRes.dll
4.2.1.2	Windows 2000	Replace	bin/jpn_jpn/BusObjDesignerRes.dll
4.2.1.2	Windows 2000	Replace	bin/cht_twn/BusObjDesignerRes.dll
4.2.1.2	Windows 2000	Replace	bin/ita_ita/BusObjDesignerRes.dll
4.2.1.2	Windows 2000	Replace	bin/deu_deu/BusObjDesignerRes.dll
4.2.1.2	Windows 2000	Replace	bin/esn_esp/BusObjDesignerRes.dll
4.2.1.2	Windows 2000	Replace	bin/ptb_bra/BusObjDesignerRes.dll
4.2.1.2	Windows 2000	Replace	bin/kor_kor/BusObjDesignerRes.dll
4.2.1.2	Windows 2000	Replace	bin/CxCommon2.dll
4.2.1.2	Windows 2000	Replace	bin/SvrIFace2.dll
4.2.1.2	Windows 2000	Replace	bin/CxCommon.dll
4.2.1.2	Windows 2000	Replace	bin/SvrIFace.dll
4.2.1.2	Windows 2000	Replace	bin/CdkTools.dll
4.2.1.2	Windows 2000	Replace	bin/Utils.dll
4.2.1.2	Windows 2000	Replace	bin/Utils411.dll
4.2.1.2	Windows 2000	Replace	bin/XRmi.dll
4.2.1.2	Windows 2000	Replace	bin/ActivityEditor.dll
4.2.1.2	Windows 2000	Replace	bin/ServerConnection.dll
4.2.1.2	Windows 2000	Replace	lib/datamanager.jar
4.2.1.2	Windows 2000	Replace	bin/cwconverter/cwconverter.jar
4.2.1.2	Windows 2000	Replace	bin/cwconverter/cwconverter.bat
4.2.1.2	Windows 2000	Replace	bin/cwconverter/com.ibm.btools.itools.cwconverter/xsls/CWM4_42/CWM4_42.xsl
4.2.1.2	Windows 2000	Replace	lib/xrmi.jar
4.2.1.2	Windows 2000	Replace	lib/cwsnmpagent.jar
4.2.1.2	Windows 2000	Replace	plugins/com.ibm.btools.csm
4.2.1.2	Windows 2000	Replace	plugins/com.ibm.btools.ics.tools
4.2.1.2	Windows 2000	Replace	plugins/com.ibm.btools.itools.cwconverter
4.2.1.2	Windows 2000	Replace	plugins/com.ibm.btools.itools.datamanager

ADDITIONAL DISCUSSION

UNINSTALL INSTRUCTIONS

 

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