Readme for
WebSphere Interchange Server (WICS) version 4.2.2.5
(Release 4.2.2.5-A)

 

The patch notes contain the following sections:

Known Problems

New Features

Completed Change Requests

Prerequisites

Upgrade Instructions

Table of files installed by this fix pack

Additional Discussion

Uninstall Instructions

 

Known Problems

45046:  WICS 4.2.2.5 InterChange Server running on a system with Japanese locale cannot connect to an Oracle database.  This problem will be corrected in a future fix pack.

 

New Features

Fix Pack Installer – New in fix pack 4.2.2.5

The WICS fix pack is now installed with an install program rather than unpacking the .tar or .zip file.

Please see the Upgrade Instructions for details.

ITLM enablement feature – New in fix pack 4.2.2.4

IBM Tivoli License Manager (ITLM) enablement - A new inventory and license management tool is bundled as part of the WebSphere InterChange Server. Version 2.1 of the IBM Tivoli« License Management (ITLM) product provides a framework for this asset management. The same ITLM product is also provided with IBM WebSphere Business Integration Toolset 4.2.2.4. In the current release of both WebSphere InterChange Server and WebSphere Business Integration Toolset the ITLM product is enabled only for inventory support..

 

 

Completed Change Requests

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

Problem tracking numbers

As of Version

Problem

71161

4.2.2.5-A

ICS receives duplicate events after MQ crash

60898

4.2.2.5

Installer provided to install server Fix Pack

60271

4.2.2.5

Installer for WICS 4.2.2.4 ITLM reports “Release Not Installed” error when installing as Root user on UNIX. 

44864

4.2.2.5

The scheduler timestamps change after it import from ICS

44363

4.2.2.5

The WSDL Binding information is missing if the property DEE set to true

60362

4.2.2.5

ADK loosing connection.

58966

4.2.2.5

Java.lang.IOException causing failed flows for LLBP collaborations.

59594

4.2.2.5

Multiple failed relationship calls causing ICS to crash.

41850

4.2.2.5

Delete a collab object,ICS.cfg file didn't remove its RECOVERY_MODE entry.

35239

4.2.2.5

ICS does not disconnect from MQ cleanly even when it is shutdown gracefully.  AMQ9208 seen in the MQ logs.

44710

4.2.2.5

Failed events of LLBP do not correctly show up in statistics

60086

4.2.2.5

DBConnection Pool Validation does not detect incorrect password when initiated from InterChange Server Instances window of System Manager.

44693

4.2.2.5

First attempt to start ICS Server fails after installing WICS 4.2.2.4 fix pack. Problem occurs using SQLServer database only. The error logged is: [Type: Fatal Error] [MsgID: 71] [Mesg: Failed to access the InterChange Server repository. Reason An error occurred during the schema creation for the repository table “java.lang.NullPointerException”. Reason: {2}..]

37471

4.2.2.5

IsConnectorAgentAlive checks status for multiple agents

37141

4.2.2.5

Cannot export map

59593

4.2.2.5

LLBP Async Inbound response fails with Mesg: Cannot find subscription for business object when the destination Agent reconnects / restarts.

36849

4.2.2.5

ICS memory leaks when different BO types are bound to IN and OUT ports of a User Collaboration. 

37749

4.2.2.5

Importing Job Schedule from ICS into an ICL does not work

42809

4.2.2.5

The Schedule can not delete from Server object

43973

4.2.2.5

relationship talbe name = 18 chars not working

44197

4.2.2.5

The status of map is always active when using repos_copy -o

59949

4.2.2.5

The use of the IBM ORB was hardcoded into the Access Framework for EJB. This has been fixed by making ORB properties configurable in               ejb-jar.xml (included in cwsession_ejb-jar.jar).

                Note: For Visibroker 4.1 / 4.5.x make sure entry vb4_back_compat is set to false.

60339

4.2.2.5

Memory leak in ICS when details of business object viewed in Flow Manager

59739

4.2.2.5

Enhanced utility for IsConnectorAgentAlive to support multiple agents. To use this feature you must create your own script to invoke the                utility. Example invocation:

                exec $(JAVA) –classpath $(CWCLASSES) IsConnectorAgentAlivesMyServer –aAgent1 –Aagent2 –aAgent3

                See Reops_Copy for a simple example of how to invoke an ICS  utility from a script

59049,46914

4.2.2.5

Adapter cannot be restarted by RetryRestartCount.  If the JDBC adapter looses connection to the database and is configured to do a    automatic restart after the database is alive, it never reconnects and fails. This has been fixed so that it reconnects.

060002,31723,31842

4.2.2.5

Relationship Sequencing not working in multithreaded environment.

 

 

 

32669

4.2.2.4

Connector property MaxEventCapacity must be in the range 1 to 2147483647. The InterChange server was not enforcing this value range.

43668

4.2.2.4

ITLM enablement in ICS 4.2.2

37133

4.2.2.4

Collaboration does not return from recovery.

32728

4.2.2.4

System monitoring of connector state changes sometimes causes errors when the connector is stopped and restarted.

33530,33602,34992,42216,58551

4.2.2.4

Incorrect values are reported for collaboration and connector statistics.

42667

4.2.2.4

Error stopping and restarting a map. If the map properties are displayed or modified in CSM while the map is active then the map cannot be stopped and restarted.

35582

4.2.2.4

Java StackOverFlow error when attempting to start out of the box collaboration.

35933

4.2.2.4

ICS has memory leaks when used with CSM

32474

4.2.2.4

LLBP Async Inbound call fails with ServiceCallException when maps are used.

37770

4.2.2.4

Dynamic property change in a collaboration of a collabgroup destroys all collaborations

34598

4.2.2.4

Agent connection to ICS is very slow after ICS has been running a long time.

35281

4.2.2.4

OAD MQ trigger: first retry does not try in the time interval specified

46029

4.2.2.4

Adapter version should always be traced. Implemented in ADK.

35026

4.2.2.4

getOriginalRequestBO API not working.

34661

4.2.2.4

Cannot deploy BO with an attribute default value containing a single quote.

35295

4.2.2.4

OAD MQ trigger: multiple boot agent commands spawns multiple Activation threads

35070

4.2.2.4

ICS fails to boot up after deploy of 2 maps with same name (with different case)

32096,34310

4.2.2.4

Memory leak caused OutofMemory exception  when using an Async Inbound collab with LLBP.

27261

4.2.2.4

Native Maps not deleted from Registry when all Native Maps are deleted

34565

4.2.2.4

MsgID:11056 - Server will be shut down because collaboration cannot delete event

30073

4.2.2.4

MQ 2033 error message filling up the log files.

33000

4.2.2.4

start_server_service.bat should not have \bin\java after %CWJAVA%

36763,58347

4.2.2.4

Adapters cannot connect to the ICS after restarting the Persistent Name Server.

36874

4.2.2.4

When the Persistent Name Server is running on a separate machine from the ICS server, recovering the name server required copying the IOR repository file from the ICS machine to Name Server machine.  This has been fixed so that there is no need to copy the file.

34315

4.2.2.4

ICS server sometimes hangs during map deployment

29249

4.2.2.4

An invalid XML character <unicode: 0x0> was found in the element content of the document

34726

4.2.2.4

Invalid messages when received by adapter running with WBIMB are lost.

34472

4.2.2.4

MQ adapter throwing OutOfMemory error when processing large event

36131

4.2.2.4

The adapter framework throwing java.lang.ClassCastException: com.ibm.jms.JMSByte

43122

4.2.2.4

BO attribute MaxLength<8, "CxIgnore" causes validation exception on WAS broker

58242

4.2.2.4

size="0" in XML message from broker to adapters causes failure with ambiguous error message:

“There is no attribute at position “x” in business object definition”

ADK fixed to handle “size=0” to indicate the absense of a child object.

33729

4.2.2.4

Enable agent to retrieve Trace/Log configuration from server

58573

4.2.2.4

Restart/Retry feature is not killing polling threads on successive retries

58883

4.2.2.4

Cannot restart standalone adapters

29963

4.2.2.4

Can start more than one adapter with the same name.  Added checking to ensure that an adapter cannot be started more than once on the same platform. A message will be displayed to the user if this condition is detected.

 

 

 

36817

4.2.2.3

ICS startup gets null pointer exception if the name server is not running. Fixed ICS to log an error and exit.

36309

4.2.2.3

A collaboration in PAUSE state cannot be started after rebooting the ICS.

36147

4.2.2.3

Dynamic update of agent trace level does not work.

30977

4.2.2.3

No error recovery in ICS for MQSeries return code 2019 (connection failure). Error recovery has been added.

28780

4.2.2.3

ICS cannot start with separate databases configured for Repository, Event Management, and Transactions.

34696

4.2.2.3

Flow Manager connecting to ICS is very slow.

42294,35738,31422

4.2.2.3

Response BO is not updated if collaboration’s “Effective transaction level” is not equal to “None”

46185

4.2.2.3

ICS IndexOutOfBounds exception in CxListBuffer fixed.

29654,35100,34856

4.2.2.3

Deploying 2 maps with the same BO’s causes explicit bindings for the maps to be lost.

34977

4.2.2.3

The Persistent Name Server does not restore the names after being restarted.

33366

4.2.2.3

Server does not generate persistent IOR file.

33337,33338,33339

4.2.2.3

Added Large Object support in ADK for the JText adapter.

34350,46118

4.2.2.3

JDBCConnector RetieveByContent verb fails if the select query encounters multiple matching records.

 

 

 

28441

4.2.2.2

Repository import from ICS to System manager takes a long time. The import time has been improved

31133

4.2.2.2

When flow monitoring a group collaboration, the events for a child and parent collaboration may be recorded in the wrong order.

32243

4.2.2.2

Added support for a custom schema name for the Flow Monitoring database. The Flow Monitoring table may now reside under a schema different than the database user name.

33219

4.2.2.2

Added messages which indicate that the server is attempting to reconnect to a lost database connection.

 

 

 

30371

4.2.2.1

ICS runs out of memory during stress runs. DataDirect Database Drivers upgraded for SQL Server and Oracle databases.

31329

4.2.2.1

An error dialog pops up during repository imported into Tools from ICS server.

32199

4.2.2.1

Adapter framework always prepends connector name to ObjectEventId. After applying this patch, a new standard connector property, EnableOidForFlowMonitoring, will be added for ICS brokers.  The property is a Boolean with a default of false.  If the property is set to true, the ADK will mark the incoming ObjectEventID as a foreign key for Flow Monitoring.

 

 

 

 

 

 

 

 

Prerequisites

 

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

2.      You must have WICS Toolset fix pack 4.2.2.5 installed. Note: you must install the WICS Server fix pack last.  Installing the Toolset fix pack after installing the WICS Server fix pack will downgrade the server files.

Upgrade Instructions 

Please read: Upgrade procedure is changed significantly from previous releases

 

Caution: Be sure when downloading the files Make sure that that setup.jar is downloaded with the .jar extension. Some download environments may append the .zip extension which will cause setup to fail.  If this happens then just rename the file to setup.jar. Do not try to unzip the file.

 

Installer restriction for AIX, HP-UX, and Solaris:

To install this fix pack on AIX, HP_UX, or Solaris you must install from the same user that was used to install the base WebSphere InterChange Server 4.2.2 product.

To upgrade to WICS 4.2.2.5

1.      Shut down the InterChange Server if it is running.

2.      Back up the files listed in the table below to allow the fix pack to be uninstalled.

3.      Download and run the fix pack installer for the system where your InterChange Server is installed.  To install this fix pack on AIX, HP_UX, or Solaris you must install from the same user that was used to install the base WebSphere InterChange Server 4.2.2 product.

4.      For Unix installations:  If you modified CWSharedEnv.sh such as changing CW_MEMORY_MAX you should make the change again to the new copy of the file installed with this fix pack. Note: if you have already installed 4.2.2.5 you can save CWSharedEnv.sh from your 4.2.2.5 installation and restore it after installing WICS 4.2.2.5-A. There are no changes to CWSharedEnv.sh between WICS 4.2.2.5 and WICS 4.2.2.5-A fix pack releases.

1.      For Windows installations: If you have modified CW_MEM_HEAP in start_server.bat or start_server_service.bat you must make the change again to the new copy of these files installed with this fix pack. Note: if you have already installed 4.2.2.5 you can save these files from your 4.2.2.5 installation and restore them after installing WICS 4.2.2.5-A. There are no changes to these files between WICS 4.2.2.5 and WICS 4.2.2.5-A fix pack releases.

Table of files installed by this fix pack

*Note that each .sys file is installed or not depending on which ICS features were installed.

Platform [Win32;Solaris;AIX;HP_UX]

Add / Replace / Remove

File (Starting from WICS installation directory)

Associated Feature

(File is installed only if the associated feature was installed)

Win32:Solaris:AIX:HP_UX

Add

bin/CC001616J040202.sys

Server

Win32:Solaris:AIX:HP_UX

Add

bin/CC000976J040202.sys

ICSAccess for EJB

Win32:Solaris:AIX:HP_UX

Add

bin/CC001133J040202.sys

ICSAccess

Win32:Solaris:AIX:HP_UX

Add

bin/CC001351J040202.sys

ICSAccess for Connectors

Win32

Replace

bin/start_server.bat

Server

Win32

Replace

bin/start_server_service.bat

Server

Win32

Replace

bin/PersistentNameServer.bat

Server

Solaris:AIX:HP_UX

Replace

bin/CWSharedEnv.sh

Server

Solaris:AIX:HP_UX

Replace

bin/PersistentNameServer.sh

Server

Win32:Solaris:AIX:HP_UX

Replace

lib/CrossWorlds.jar

Server

Win32:Solaris:AIX:HP_UX

Replace

lib/datamanager.jar

Server

Win32:Solaris:AIX:HP_UX

Replace

lib/cwsnmpagent.jar

Server

Win32:Solaris:AIX:HP_UX

Replace

lib/ConfigWizard.jar

Server

Win32:Solaris:AIX:HP_UX

Replace

lib/xwbase.jar

Server

Win32:Solaris:AIX:HP_UX

Replace

lib/xworacle.jar

Server

Win32:Solaris:AIX:HP_UX

Replace

lib/xwsqlserver.jar

Server

Win32:Solaris:AIX:HP_UX

Replace

lib/xwutil.jar

Server

Win32:Solaris:AIX:HP_UX

Add

lib/ITLMToolkit.jar

Server

Win32:Solaris:AIX:HP_UX

Add

lib/jlog.jar

Server

Win32:Solaris:AIX:HP_UX

Replace

messages/InterchangeSystem.txt

Server

Win32:Solaris:AIX:HP_UX

Replace

DevelopmentKits/J2EE/EJB/cwsession_ejb-jar.jar

ICSAccess for EJB

 

Additional Discussion

 This is a re-release of WebSphere Interchange Server (WICS) version 4.2.2.5 fix pack with the fix for problem 71161 included. The server version remains 4.2.2.5; but the server log will also include the message: “Release 4.2.2.5-A”.

 

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.

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