Fix Pack Notes for
WebSphere Interchange Server (WICS) version 4.2.1.3

The patch notes contain the following sections:

Completed Change Requests

Upgrade Instructions

Additional Discussion

Unistall Instructions

Completed Change Requests

This patch contains fixes for the following CRs based on customer reported and internally discovered issues.

Problem tracking numbers	As of Version	Problem
25471	4.2.1.3	Fixes the XML datahandler problem when it was not able to parse the XML message that contained no namespace definitions To support the parsing of xml messages without namespaces defined, you must add a connector-specific property to the connector definition called XMLNameSpaceFormat. The value of this property should be set to 'no'
25880	4.2.1.3	MQ exception rc=2019 using SAP adapter with large (25mb) messages when MQ connection failure occurs. This fix enables the ics to recover from the MQ connection failure without exception
25927	4.2.1.3	When apache v2.0.2 xml parser is used performance is slower. This fixes the performance problem.
29943	4.2.1.3	repos_copy command with –arp option had an intermittent error that caused a failure to deploy the repository updates in WICS version 4.2.1.1. This fixes the problem.
28179	4.2.1.3	Rosetta Net deploy maps causes Null Pointer Exception in server - In the connector definition, if the explicit binding box is checked, and set to <none> we get a Null Pointer Exception in the server during deploy of the maps.
27719	4.2.1.3	WBIA 2311 Err. msgs no longer appended to XML message
24895	4.2.1.3	Deploy with compile errors: no error message in System Manager. Requires WICS Tools fix pack version 4.2.1.3.
22144	4.2.1.1	Exception starting the TPI Adapter “Incompatible object argument for function call” was caused by incompatible version of xerces (v2.0.2). The problem is fixed.
24556	4.2.1.1	Problem: Subject of Email sent by logError() is not easy to read. Fixed in this Fix Pack
24600	4.2.1.1	Problem solved: With CR we are reducing the size of xml that is sent to WMQI. This is done by compressing the namespaces in the bo xml document. This is a configurable behavior. Standalone connectors that want to use it need to configure a property "XMLNameSpaceFormat" and set its string value to "short" (without the quotes of course). They can add this property to the app specific property in the connector config file with the help of Conn Designer. If this property has value "long" or if the property is absent then current behavior of long namespaces is the default. short XMLNameSpaceFormat is supported only with RFH2MessageDomain standard property set to 'xml'. When RFH2MessageDomain is set to 'mrm', only long XMLNameSpaceFormat is supported.
22249	4.2.1.1	Fixed memory leak that caused server crash on deploy or export of large repository. Related WBI Tools CR 22935
24735	4.2.1.1	Adapter could not be restarted after changing the “encrypted” option. Error message was “Unable to decrypt the attribute using ID. Reason: Encrypted property value is wrong.” The problem is fixed by this fixpak.

Upgrade Instructions

To upgrade to WICS 4.2.1.3

1. Back up the listed files first to allow the fix pack to be uninstalled.
2. Apply the changes prescribed in the table below:
3. For AIX, Solaris, or HP_UX systems, run the script bin/ics4213_patch.sh. This script must be run from the bin directory of your WICS installation. This script will modify the file: bin/CWSharedEnv.sh to improve the performance of WICS when XERCES v2.0.2 XML parser is being used. The script also makes a backup copy in bin/CWSharedEnv.sav4213.

Platform [Win32;Solaris;AIX;HP_UX]	Add / Replace / Remove	File (Starting from WICS installation directory)
Win32:Solaris:AIX:HP_UX	Replace	lib/CrossWorlds.jar
Win32:Solaris:AIX:HP_UX	Replace	lib/cworion.jar
Win32:Solaris:AIX:HP_UX	Replace	lib/datamanager.jar
Win32:Solaris:AIX:HP_UX	Replace	lib/xrmi.jar
Win32:Solaris:AIX:HP_UX	Replace	messages/InterchangeSystem.txt
Win32	Replace	DevelopmentKits/cdk/lib/Release/CwConnector.dll
Win32	Replace	DevelopmentKits/cdk/lib/Release/CwConnector.lib
Win32	Replace	DevelopmentKits/cdk/lib/Debug/CwConnector.dll
Win32	Replace	DevelopmentKits/cdk/lib/Debug/CwConnector.lib
Win32	Replace	bin/cwservice.exe
Win32	Replace	bin/start_server.bat
Win32	Replace	bin/SrvIFace.dll
Win32	Replace	bin/Utils.dll
Win32	Replace	bin/CdkTools.dll
Win32	Replace	bin/CwConnector.dll
Solaris:AIX:HP_UX	Add	bin/ics4213_patch.sh
Solaris:AIX	Replace	lib//libbenchmark.so
Solaris:AIX	Replace	lib/libCwConnector.so
Solaris:AIX	Replace	lib/libCwPorting.so
Solaris:AIX	Replace	lib/libMemoryService.so
Solaris:AIX	Replace	lib/libpasswordInput.so
HP_UX	Replace	lib/libCwPorting.sl
HP_UX	Replace	lib/libCwConnector.sl

Prerequisites

1. You must have version 4.2.1 of WICS installed in order to install this fix pack.

Additional Discussion

Uninstall Instructions

1. When installing the fix pack, you should first back up all the old files that are being replaced. To uninstall this fix pack, replace the new files with the backed-up files.

2. To uninstall this fix pack for AIX, Solaris, and HP_UX systems you must also replace the file bin/CWSharedEnv.sh with the backed up copy: bin/CWSharedEnv.sav4213.

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