Fix Pack Notes for

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

The patch notes contain the following sections:

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
31422	4.2.1.5	Fixed such that Transactional Collaboration receives the updated BO from the Agent in response to a Service Call
24568	4.2.1.4B	The SNMP Agent was causing memory leak for the WebSphere Interchange Server and itself. This fix was listed in the WICS Tools fix pack 4.2.1.2 but is not fixed unless cwsnmpagent.jar is installed on the system where the SNMP agent is installed.
30073	4.2.1.4	MQ Reason Code 2033 message shows up way too many times in the ICS log and stderr, making them difficult to understand. So this fix excludes MQ Reason code 2033 message from appearing.
23011	4.2.1.4	ObjectEventId generated by mapping Infrastructure was not always unique for both parent and child BO. Fixed in this Fix Pack
30350	4.2.1.4	Some failed events are not showing up in the flow manager as expected
25930	4.2.1.4	Collaboration group breaks when duplicate names exists for collaborations and connectors
25932	4.2.1.4	FlowControl resource creation fails when duplicate connector and collaborations exist.
28966, 27584	4.2.1.4	ASync Inbound Service call is processed as a failed event when there are no subscribers for the BO. ICS traces (@trace level 2) the SQL Exception to ICS trace file instead of ICS log
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.5

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: If you have not already installed WICS 4.2.1.3 fixpack then you must back up the file bin/CWSharedEnv.sh and 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. You should make your own back up copy for uninstall purposes. The presence of you own back up copy will indicate that the file needs to be replaced in uninstall.

4. If you are using the SNMP Agent then the file lib/cwsnmpagent.jar must be replaced on the machine where the SNMP Agent is running.

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:Solaris:AIX:HP_UX	Replace	lib/cwsnmpagent.jar (install on SNMP Agent machine)
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/CdkTools.dll
Win32	Replace	bin/CwConnector.dll
Win32	Replace	bin/HAICS.dll
Win32	Replace	bin/HAICSex.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. For AIX, Solaris, and HP_UX systems: If you updated bin/CWSharedEnv.sh as in step 3 of the installation instructions above; then you must also replace this file with your back-up copy.