Fix Pack Notes for
WebSphere Business Integration Adapter Framework
Version 2.6.0.3
The patch notes contain the following
sections:
This patch contains fixes for the following customer-reported and internally discovered issues and enhancements.
Adapter Framework runtime changes
Problem tracking numbers |
As of Version |
APAR Number |
Problem |
61907 |
2.6.0.3 |
JR21718 |
Unexpected exception for
CwConnector.dll |
62206 |
2.6.0.3 |
JR21579 |
Siebel COM Connector is failing once
in a while |
60690 |
2.6.0.3 |
JR21987 |
4.2.2.4 ICS breaks interfaces that the
Siebel COM connector uses |
71559 |
2.6.0.3 |
JR21799 |
Duplicate ObjectEventID |
71311 |
2.6.0.3 |
JR21772 |
Siebel adapter hangs if it gets a
Siebel-specific application error |
71515 |
2.6.0.3 |
JR21718 |
After pressing 'q' to exit the Siebel
adapter, we get a fatal error |
71399 |
2.6.0.3 |
JR21689 |
Agent should stop polling
events once the current MQ depth exceeds 90 percent of maximum depth |
72342 |
2.6.0.3 |
JR22046 |
Customer gets a Call Stack error while
starting the Siebel adapter |
66866 |
2.6.0.3 |
(Enhancement) |
MQ source does not stop polling when ICS
is killed |
70839 |
2.6.0.3 |
- |
ADK fix for WBI Server Express 4.4 - iSeries controlled end of adapter |
60381 |
2.6.0.3 |
JR21959 |
cwservice command has 2 times -t
option |
71857 |
2.6.0.3 |
JR21842 |
P.E.
Synchronous scenarios do not work in 4.3.0.1 |
70953 |
2.6.0.3 |
JP21630 |
Error message in case of different BO
schema and XML sequence |
70841 |
2.6.0.3 |
JR21967 |
HTTP Adapter: Out of memory |
70797 |
2.6.0.3 |
JR21986 |
Invalid JMS type message needs to be
clearer |
66754 |
2.6.0.3 |
JR21962 |
Meaning of MsgID:
165 |
66616 |
2.6.0.3 |
JR21352 |
SAP adapter can't restart when there
is an RFC_ERROR_SYSTEM_FAILURE error |
70895 |
2.6.0.3 |
JR21958 |
Message needs to be more meaningful |
66664 |
2.6.0.3 |
JR21414 |
Flooding IDLControllerProxy
fatal error : CORBA ORB connection error |
07633 |
2.6.0.3 |
(Enhancement) |
DataHandler base class provides a mechanism for
displaying the version |
35953 |
2.6.0.3 |
(Enhancement) |
Provide
printStackTrace functionality in base datahandler class |
25927 |
2.6.0.3 |
(Enhancement) |
Set
property when using Xerces 2 |
33724 |
2.6.0.3 |
(Enhancement) |
Support
for running an adapter as a service in stand-alone mode |
37142 |
2.6.0.3 |
(Enhancement) |
Exit
when the adapter message file is missing |
28564 |
2.6.0.3 |
(Enhancement) |
Print
the Adapter Framework version |
59606 |
2.6.0.3 |
(Enhancement) |
Support SUSE Linux Enterprise Server(ES)/ Standard
Server(SS) 9.0 |
60616 |
2.6.0.3 |
(Enhancement) |
Update
JRE Service pack to JRE 1.4.2 SR1 |
60612 |
2.6.0.3 |
(Enhancement) |
Support
WBIMB V5.0 CSD04 |
60615 |
2.6.0.3 |
(Enhancement) |
Support
WMQI V2.1 CSD08 |
60614 |
2.6.0.3 |
(Enhancement) |
Support
WBISF 5.1.1 |
59603 |
2.6.0.3 |
(Enhancement) |
AF/ADK
to provide LINUX support for CEI |
61985 |
2.6.0.2 |
|
Connector_manager
-stopgraceful SAP does not work as documented |
44949 |
2.6.0.2 |
|
2.6 Adapter runtime can't accept a CFG file that
has a version of 4.4.0 |
60685 |
2.6.0.2 |
|
WBIA Framework 2.4 recognizes "mrm" not "MRM" |
43926 |
2.6.0.2 |
|
Connector and tool require to put CHANNEL and PORT
when using local MQ binding |
37590 |
2.6.0.2 |
|
The Adapter Framework 2.4.0 fails when converting
an XML message |
61281 |
2.6.0.2 |
|
The SAP adapter version 2.6 is not sending invalid
messages to the Fault queue. |
61176 |
2.6.0.2 |
|
An error is thrown when the HTTP Adapter 1.2.0.1IF
polls using JMS as DeliveryTransport |
44904 |
2.6.0.2 |
|
JMS transported adapter can't get the response in Sync model |
44363 |
|
|
When
|
44635 |
|
|
The
adapter pollForEvents does not work in
MAIN_SINGLE_THREADED mode |
59316 |
|
(Enhancement) |
Provide
built-in message audit and tracking functionality for Adapter Framework |
58998 |
|
(Enhancement) |
Security exits/JMS transport not handled in the adapter |
59346 |
|
|
Wrong
com.crossworlds.DataHandlers.cwxml generated by the Adapter Framework |
44746 |
|
|
Print
the Adapter Framework version |
WBI Toolset changes
Problem tracking numbers |
As of Version |
Problem |
44484 |
4.3.0.1 |
Need a new connector
property to explicitly turn on/off BO auditing message |
60329 |
4.3.0.1 |
Slow ICS
bring-up time causes auto-start adapters to fail on start-up |
45637 |
4.3.0.1 |
Connector Configurator should validate the values of connector-specific
propertiess |
44774 |
4.3.0.1 |
Add
"no" option to property XMLNameSpaceFormat |
45148 |
4.3.0.1 |
The description
of standard property SynchronousRequestTimeout is
incorrect. |
44800 |
4.3.0.1 |
The version of the
adapter is wrongly displayed in Adapter Monitor |
59069 |
4.3.0.1 |
zh_tw_pre-TVT_english string on Load Adapter |
45586 |
4.3.0.1 |
"adminmgr" does not work normally |
62182 |
4.3.0.1 |
Slow performance with
Business Object Designer version 4.3 |
61342 |
4.3.0.1 |
ICL projects
disappear from System Manager |
60726 |
4.3.0.1 |
Cannot launch
Log Viewer by specifying the log file as an argument |
61190 |
4.3.0.1 |
Business-object
level application-specific information disappears on restarting Business
Object Designer |
To perform an upgrade to this version of the WBI Adapter Framework:
1.
This is a fix pack to be applied to WBI Adapter Framework
version
2. Technote for the installation of AF fix pack 2.6.0.3
3. Run the fix pack Installer corresponding to the operating system.
Please refer to the Installer technical notes for instructions on installing Adapter Framework 2.6.0.x on AIX 5.3.
Please refer to the Installer technical notes for instructions on installing Adapter Framework 2.6.0.x on SuSE 9.0.
Table
of Adapter Framework runtime files installed by this fix pack:
Platform [Win32;Solaris;AIX;HP_UX;Linux] |
Add / Replace / Remove |
File (Starting from WBIA
installation directory) |
Win32:Solaris:AIX:HP_UX :Linux |
Replace |
wbiart/wbiart.jar |
Win32:Solaris:AIX:HP_UX :Linux |
Replace |
messages/WBIAdapterRuntime.txt |
Win32:Solaris:AIX:HP_UX :Linux |
Replace |
|
Win32:Solaris:AIX:HP_UX :Linux |
Replace |
license.txt |
Win32:Solaris:AIX:HP_UX :Linux |
Replace |
notices.txt |
Win32:Solaris:AIX:HP_UX :Linux |
Replace |
lib/jmsmgr.jar |
Win32 |
Replace |
bin/cwservice.exe |
Win32 |
Replace |
bin/start_adapter.bat |
Solaris:AIX:HP_UX :Linux |
Replace |
bin/adapterEnv.sh |
Solaris:AIX:HP_UX :Linux |
Replace |
bin/start_adapter.sh |
Win32:Solaris:AIX:HP_UX
:Linux |
Replace |
AdapterJRE/ (whole Dir) |
Win32:Solaris:AIX:HP_UX :Linux |
Add |
jdk/ (whole
Dir) |
Table of Toolset files installed by this fix pack – For Windows installations only:
Platform
[Win32;Solaris;AIX;HP_UX;Linux] |
Add / Replace / Remove |
File (Starting from WBIA installation
directory) |
Win32 |
Replace |
bin/Data/Std/StdConnProps.xml |
Win32 |
Replace |
bin/Data/Std/StdConnProps_chs_chn.xml |
Win32 |
Replace |
bin/Data/Std/StdConnProps_cht_twn.xml |
Win32 |
Replace |
bin/Data/Std/StdConnProps_deu_deu.xml |
Win32 |
Replace |
bin/Data/Std/StdConnProps_esn_esp.xml |
Win32 |
Replace |
bin/Data/Std/StdConnProps_fra_fra.xml |
Win32 |
Replace |
bin/Data/Std/StdConnProps_ita_ita.xml |
Win32 |
Replace |
bin/Data/Std/StdConnProps_jpn_jpn.xml |
Win32 |
Replace |
bin/Data/Std/StdConnProps_kor_kor.xml |
Win32 |
Replace |
bin/Data/Std/StdConnProps_ptb_bra.xml |
Win32 |
Replace |
bin/BusObjDesigner.exe |
Win32 |
Replace |
bin/ConnDesigner.exe |
Win32 |
Replace |
bin/LogViewer.exe |
Win32 |
Replace |
bin/enu_usa/ConnDesignerRes.dll |
Win32 |
Replace |
bin/chs_chn/ConnDesignerRes.dll |
Win32 |
Replace |
bin/fra_fra/ConnDesignerRes.dll |
Win32 |
Replace |
bin/jpn_jpn/ConnDesignerRes.dll |
Win32 |
Replace |
bin/cht_twn/ConnDesignerRes.dll |
Win32 |
Replace |
bin/ita_ita/ConnDesignerRes.dll |
Win32 |
Replace |
bin/deu_deu/ConnDesignerRes.dll |
Win32 |
Replace |
bin/esn_esp/ConnDesignerRes.dll |
Win32 |
Replace |
bin/ptb_bra/ConnDesignerRes.dll |
Win32 |
Replace |
bin/kor_kor/ConnDesignerRes.dll |
Win32 |
Replace |
bin/CxCommon2.dll |
Win32 |
Replace |
bin/ServerConnection.dll |
Win32 |
Replace |
bin/XRmi.dll |
Win32 |
Replace |
bin/SMInterface.dll |
Win32 |
Replace |
lib/CrossWorlds.jar |
Win32 |
Replace |
lib/datamanager.jar |
Win32 |
Replace |
lib/vtc.jar |
Win32 |
Replace |
Tools/eclipse/plugins/com.ibm.btools.csm |
Win32 |
Replace |
Tools/eclipse/plugins/com.ibm.btools.itools.common |
Win32 |
Replace |
Tools/eclipse/plugins/com.ibm.btools.itools.codeGen |
Win32 |
Replace |
Tools/eclipse/plugins/com.ibm.btools.itools.ae.settings |
Win32 |
Replace |
Tools/eclipse/plugins/com.ibm.btools.itools.cwconverter |
Win32 |
Replace |
Tools/eclipse/plugins/com.ibm.btools.itools.datamanager |
Win32 |
Replace |
Tools/eclipse/plugins/com.ibm.btools.itools.wsdlgen |
Win32 |
Replace |
Tools/eclipse/plugins/com.ibm.btools.adaptermonitor |
Win32 |
Replace |
Tools/eclipse/plugins/com.ibm.btools.bdm |
Prerequisites
You must have WBI Adapter Framework version
ADDITIONAL THIRD PARTY SOFTWARE SUPPORT
Software |
Version and patch |
Support From Version |
Comments |
Operating system |
|||
Windows XP |
Service Pack 2 |
2.6.0.3 |
Supported only for development CR71584 |
AIX 5.3 |
|
2.6.0.2 |
|
Red Hat
Enterprise Linux 3.0 RHEL 3.0 ES RHEL 3.0 AS RHEL 3.0 WS |
Update 3 |
2.6.0.3 |
|
SUSE Linux Enterprise Server(ES) SUSE Linux
Standard Server(SS) |
9.0 |
2.6.0.3 |
CR59606 |
Integration broker |
|||
WebSphere Application
Server, |
5.0.2.6 |
2.6.0.3 |
|
WebSphere Business Integration Server Foundation |
5.1.1 |
2.6.0.3 |
CR60614 |
IBM WebSphere
MQ Integrator Broker |
2.1 CSD08 |
2.6.0.3 |
CR60615 |
WebSphere Business Integration Message Broker |
5.0 CSD04 |
2.6.0.3 |
CR60612 |
WebSphere InterChange Server |
4.3.0.1
|
2.6.0.3 |
|
Other softwares |
|||
IBM WebSphere
MQ Server and Client |
5.3.0.2 with CSD08 and CSD10. |
2.6.0.3 |
CR71901 |
Common Event Infrastructure |
- |
2.6.0.3 |
AF/ADK to provide LINUX support for CEI CR59603 |
Java Development Kit/Java Runtime Environment |
|||
IBM JDK/JRE (for
Windows, AIX, Solaris, HP-UX, and Linux computers) |
1.4.2 SR1 |
2.6.0.3 |
CR 60616 |
ADDITIONAL DISCUSSION
1. To enable the MQ Security Exit (CR58998) for the adapter:
- Launch
Connector Configurator then set the type of 'DeliveryTransport' to 'JMS'
- Input the class name MQ Security Exit as the last element using
this format:
'queue_manager_name:channel_name:host_name:port_number:mq_security_exit_name'
- Put the class MQ Security Exit in the library path or extend the
path of the adapter
- When the adapter is launched, the MQ Security Exit will be invoked. If MQ Security Exit cannot be found, this feature will be treated as disabled.
Note: Because MQ Security Exit applies to queue
manager, products do not support MQ Security Exit feature should not use the
same queue manager as Adapter Framework.
1. To use the BO trace (CR59316) feature:
1) Enable 'BOTrace' property:
- Users of ICS or a standalone broker may use the '-x' parameter in the agent start script to configure the 'BOTrace' property if the patch for the Connector Configurator is not available; for example '-xBOTrace=Full'.
- If the patch for Connector Configurator patch is available, the user can configure the 'BOTrace' property in Connector Configurator.
2) The 'BOTrace' values are as follows:
When 'AgentTraceLevel' is 5, the property 'BOTrace' is not available.
When 'AgentTraceLevel' is lower than 5:
- Set 'BOTrace' to 'Full' to dump all the BO's attributes.
- Set 'BOTrace' to 'Keys' to dump only the BO's keys.
- Set 'BOTrace' to 'None' to disable BO attribute dumping.
2.
To support no namespace
BO(CR37590)
If the “no” option was not available for the property XMLNameSpaceFormat in Connector Configurator, the user should edit the Connector Configuration file manually, as described below. (It should be added in the WebSphere Business Integration (WBI) Toolset version 4.3.0.1)
- Open the Connector Configuration file in a text editor.
- Locate the “XMLNameSpaceFormat” property by searching. Here is an example:
<tns:property>
<tns:name>XMLNameSpaceFormat</tns:name>
<tns:type>String</tns:type>
<tns:subtype></tns:subtype>
<tns:value xml:space="preserve">short</tns:value>
<tns:description>Supports short and long name spaces in the BO's XML doc on the wire.</tns:description>
- Replace the value “short” or “long” by “no”, as follows:
<tns:property>
<tns:name>XMLNameSpaceFormat</tns:name>
<tns:type>String</tns:type>
<tns:subtype></tns:subtype>
<tns:value xml:space="preserve">no</tns:value>
<tns:description>Supports short and long namespaces in the BO's XML doc on the wire.</tns:description>
3.
AIX 5.3 supporting:
WebSphere Business Integration Adapter Framework has supported AIX 5.3 since version 2.6.0.2.
4. To enable Adapter Monitor to support the MQ Security Exit feature(CR58998):
- Put the class MQ Security Exit into the directory <AF Installer>\Tools\eclipse\plugins\com.ibm.btools.adaptermonitor\lib.
- Modify the Adapter Monitor's plug-in manifest file plugin.xml which resides in the directory <AF Installer>\Tools\eclipse\plugins\com.ibm.btools.adaptermonitor. In the <runtime> segment, add a library name entry for MQ Security Exit.
For example, suppose MyMQExit.zip includes this class. Add the following library name entry to the <runtime> segment of plugin.xml.
<library name="lib\MyMQExit.zip"/>
5.
To enable the
enhancement(CR66866) with MQ DeliveryTransport for
the adapter:
A new command line parameter 'WhenServerAbsent' is incorporated to indicate whether the adapter with MQ transport should pause or shut down when ICS is killed. ICS users may use the '-x' parameter in the agent start script to configure the 'WhenServerAbsent' property; for example:
-xWhenServerAbsent=shutdown //Adapter
with MQ transport will shut down if ICS is not available
-xWhenServerAbsent=pause //Adapter with MQ transport will pause if ICS is not
available
If the option is not set, the adapter will keep polling by default
1. To uninstall this fix pack, please refer to the Installer technical notes.
©
2005 IBM Corporation. Proprietary and Confidential. All Rights Reserved.
IBM
WebSphere® Business Integration