Readme for
WebSphere Interchange Server (WICS) version 4.2.2.4
The patch notes contain the following sections:
New in this release – ITLM
enablement feature
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
This patch contains fixes for the following customer reported
and internally discovered issues.
Problem tracking numbers |
As of Version |
Problem |
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. |
Please read: Upgrade procedure is changed significantly from previous releases
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.4
1.
Download all 4 files from the appropriate download link
according to your WICS server operating system.
2.
Back up the files listed in the
table below to allow the fix pack to be uninstalled.
3.
Unpack the zip or tar package to
the WICS installation directory. For example on AIX® extract WICS_4224_AIX.tar
to /usr/home/WebSphereICS if that is your
installation directory.
4.
Run the ITLM installer: setup.bin
or setup.exe. Installation of this ITLM feature is required with WICS 4.2.2.4
fix pack.
5. For Unix installations only: update bin/PersistentNameServer.sh as follows:
a)Replace
line 15 “. VAR_CWHOME/bin/CWSharedEnv.sh” with the
corresponding line from the original file backed up un
step 1.
b) For the Java command to start the TransientnameServer, set the JVM property CosNamingPersistencyFile to point to the file CxCosNameRepos.ior in the ICS installation directory. For example: add -DCosNamingPersistencyFile="/usr/home/WebSphereICS422/CxCosNameRepos.ior"
as follows:
# start tname
server
exec ${JAVA}
-DCosNamingPersistencyFile="/usr/home/WebSphereICS422/CxCosNameRepos.ior"
${COS_NAME_HOOK} -classpath ${CWCLASSES} com.ibm.CosNaming.TransientNameServer -ORBInitialPort
${ORB_PORT}
6. For Unix installations only: Update CWSharedEnv.sh as follows:
a) Insert the
following line just above CWCLASSES: ITLM=${CROSSWORLDS}/lib/ITLMToolkit.jar:${CROSSWORLDS}/lib/jlog.jar
b) Append "${ITLM}:"
to CWCLASSES line resulting in:
CWCLASSES=${JRT}:${WLICENSE}:${CORECW}:${DATAHANDLERS}:${DATADI RECT}:${XML_PARSER}:${DATAMANAGER}:${ITLM}:
Table of files installed by this fix pack
Platform [Win32;Solaris;AIX;HP_UX] |
Add / Replace /
Remove |
File (Starting from WICS installation directory) |
Win32:Solaris:AIX:HP_UX |
Add |
bin/CC001616J040202.sys |
Win32:Solaris:AIX:HP_UX |
Add |
bin/CC000976J040202.sys |
Win32:Solaris:AIX:HP_UX |
Add |
bin/CC001133J040202.sys |
Win32:Solaris:AIX:HP_UX |
Add |
bin/CC001351J040202.sys |
Win32 |
Replace |
bin/start_server.bat |
Win32 |
Replace |
bin/start_server_service.bat |
Win32 |
Replace |
bin/PersistentNameServer.bat |
Solaris:AIX:HP_UX |
Replace |
bin/PersistentNameServer.sh |
Win32:Solaris:AIX:HP_UX |
Replace |
lib/CrossWorlds.jar |
Win32:Solaris:AIX:HP_UX |
Replace |
lib/xwbase.jar |
Win32:Solaris:AIX:HP_UX |
Replace |
lib/xworacle.jar |
Win32:Solaris:AIX:HP_UX |
Replace |
lib/xwsqlserver.jar |
Win32:Solaris:AIX:HP_UX |
Replace |
lib/xwutil.jar |
Win32:Solaris:AIX:HP_UX |
Add |
lib/ITLMToolkit.jar |
Win32:Solaris:AIX:HP_UX |
Add |
lib/Jlog.jar |
Win32:Solaris:AIX:HP_UX |
Replace |
messages/InterchangeSystem.txt |
Prerequisites
1. You must have version 4.2.2 of WICS installed in order to install this fix pack.
2. This server fix pack requires that you install WICS Toolset fix pack
4.2.2.4 or later.
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.
© 2004 IBM Corporation. Proprietary and Confidential. All Rights Reserved.