Fix
Pack Notes for
WebSphere Business Integration Adapter Framework
Version 2.6.0.7
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 |
85309 |
2.6.0.7 |
JR25307 |
JDBC Adapter takes 20 mins to go down after lost connection with DB |
86571 |
2.6.0.7 |
JR25311 |
ADK is not populating the required verb attribute on child BO when putting the message on the DeliveryQueue |
2.6.0.7 |
JR25440 |
Adapter Framework does not convert NULL
to correct XML message |
|
86981 |
2.6.0.7 |
JR25519 |
Adapter fails to start when windows
service is automatic |
87208 |
2.6.0.7 |
JR25610 |
Error message incomplete while parsing
message from request queue |
69055 |
2.6.0.7 |
- |
JMS customer properties are lost in
fault message |
86633 |
2.6.0.7 |
- |
ADK support for the CEI server that comes with WPS |
68997 |
2.6.0.7 |
- |
Upgrade JRE/SDK embedded in WBI
Adapter Framework to version 1.4.2SR6 |
2.6.0.7 |
(Enhancement) |
Adapter should be shut down gracefully if DeliveryTransport is JMS |
|
85776 |
2.6.0.6 |
JR24871 |
ObjectEventIDs generated by ADK are not unique in any cases |
84100 |
2.6.0.6 |
JR23728 |
MQ adapter pauses when queue is not 90% full |
68129 |
2.6.0.6 |
JR23778 |
messages NOT back out to reply queue if network error during adapter processing |
83747 |
2.6.0.6 |
JR23542 |
AF 2.6 on Solaris - Failed flows created when adapter slave crashes |
83647 |
2.6.0.6 |
JR23473 |
Events skipped during polling for Clarify adapter and AF2603 LAIF4 |
83678 |
2.6.0.6 |
JR23496 |
Adapters in retry mode opening new channels in MQ |
83778 |
2.6.0.6 |
JR23558 |
Use the connector_manager –stop can not stop the adapter when adapter in retry mode |
68015 |
2.6.0.6 |
JR23481 |
Message lost when being replied to a queue has been put disable |
68031 |
2.6.0.6 |
JR23500 |
When the message was send to Fault queue, the Priority is changed to 4 |
68172 |
2.6.0.6 |
JR23901 |
When the customer set the max size of the log file and archived number, the log file increased without archived file |
83817 |
2.6.0.6 |
JR23579 |
MQ adapter logs to incorrect path when getting properties from repository |
84352 |
2.6.0.6 |
JR23880 |
String index out of range error occurs when parsing BO message, the same BO message can be parsed correctly with AF2.3.1 |
84547 |
2.6.0.6 |
JR24080 |
ADK throws nullException at Retry Reconnect |
84364 |
2.6.0.6 |
JR23896 |
The message which the JMSType is null disappeared after processed by ADK |
83918 |
2.6.0.6 |
JR23640 |
Logging trace messages in the adapter log with trace level set to 0 |
83732 |
2.6.0.6 |
JR23533 |
Adapter not able to reconnect and restart using JMS as delivery transport |
83221 |
2.6.0.6 |
JR23439 |
The adapter can not bind to port when adapter restart(start adapter by Cwservice), the message is 9202 and 9203 |
84473 |
2.6.0.6 |
JR24237 |
CxBlank is printed in the XML |
84957 |
2.6.0.6 |
JR24319 |
Trace file rotation not working for connectors started without config file |
85243 |
2.6.0.6 |
JR24489 |
The Locale is not set when the adapter started without config file |
85294 |
2.6.0.6 |
JR25090 |
Defect Outbound HTTP adapter locks up due to MQ problem with HTTP 404 |
2.6.0.6 |
JR24057 |
Adapter Agent restart & retry 5 times to connect to ICS then abort |
|
68724 |
2.6.0.6 |
JR24663 |
Message not came into fault Q |
68764 |
2.6.0.6 |
JR24751 |
Adapter failed to restart due to NullPointerException |
2.6.0.6 |
- |
Remove embedded JDBC drivers from ADK |
|
2.6.0.5 |
JR23106 |
Master process cannot handle slave processes |
|
82969 |
2.6.0.5 |
JR23053 |
MQ adapter v2.8.1 application password is valid in authentication |
82963 |
2.6.0.5 |
JR23042 |
Adapter fails events during Slave restart |
73853 |
2.6.0.5 |
JR23105 |
Can not set Parallel Process Degree >1 for C adapters with ICS 4.3 |
82985 |
2.6.0.5 |
JR23042 |
All PPD Slaves are stop processing while 1 or more slaves are restarting |
82923 |
2.6.0.5 |
JR23003 |
Java-level deadlock for adapter in AF 2.6 when one of the slave processes dies |
82940 |
2.6.0.5 |
JR23940 |
Adapters throw Exception when trying to close connection and restart. |
74545 |
2.6.0.5 |
JR23492 |
WSMQ adapter throws null pointer exception |
67922 |
2.6.0.5 |
JR23007 |
-server in adminmgr.sh should be deleted (AIX) |
55989 |
2.6.0.5 |
JR22894 |
When starting an adapter that is already running, it overwrites the PID |
67835 |
2.6.0.5 |
- |
Adapter failed to restart if poll thread had not been inited successfully |
74177 |
2.6.0.5 |
JR23358 |
com.crossworlds.DataHandlers.text.delimited hits java.lang.ArrayIndexOutOfBounds |
67066 |
2.6.0.5 |
JR21904 |
Delimited DH parse error convert string to BO with embedded Delimited chars |
83146 |
2.6.0.5 |
JR23146 |
Not able to view BO strcuture via Log Viewer |
72719 |
2.6.0.5 |
JR21558 |
Improve the work quality of adminmgr.bat/sh by adding retry mechanism |
74226 |
2.6.0.5 |
(Enhancement) |
MQ Adapter and Adapter Framework behavior for duplicate events |
72183 |
2.6.0.4 |
JR22842 |
ClassCastExceptions in MQConnector |
61774 |
2.6.0.4 |
JR22843 |
Controller/agent trace levels do not get dynamically updated |
2.6.0.4 |
JR22327/JR22844 |
Msg can not be converted to BO with ADK 2.6.0, which was working fine with 2.4 |
|
67476 |
2.6.0.4 |
JR22845 |
The pollforevent message printed in the trace file when trace level is 1 |
72403 |
2.6.0.4 |
JR22122 |
HTTP Adapter fails after getting incomplete message |
2.6.0.4 |
JR22846 |
Why are local config files needed for logging for connectors? |
|
73521 |
2.6.0.4 |
JR22847 |
Adapter crashes with error 17069 if it cannot find its message file - no stack |
71274 |
2.6.0.4 |
JR22849 |
connector_manager -stat gives incorrect results |
71268 |
2.6.0.4 |
JR21551 |
MQDEAD message stays in delivery and fault queue |
71388 |
2.6.0.4 |
JR22850 |
Log messages in the log file when kill -9 option is used |
72509 |
2.6.0.4 |
JR22109 |
RequestResponse DH throws java class not found exception |
74028 |
2.6.0.4 |
JR22747 |
Child verbs changed from CxBlank to CxIgnore in AF 2.6 |
74255 |
2.6.0.4 |
JR22851 |
Adapterenv.sh needs to be corrected in AF 2.6.x.x |
2.6.0.4 |
(Enhancement) |
WBI Adapter Framework backed-out message processing function |
|
2.6.0.3 |
- |
There should have a value for an attribute which ‘Required Attribute’ parameter is true. (see Additional Discussion section below) |
|
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 |
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 |
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 |
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 |
2.6.0.1 |
|
When |
44635 |
2.6.0.1 |
|
The adapter pollForEvents does not work in MAIN_SINGLE_THREADED mode |
2.6.0.1 |
(Enhancement) |
Provide built-in message audit and tracking functionality for Adapter Framework |
|
2.6.0.1 |
(Enhancement) |
Security exits/JMS transport not handled in the adapter |
|
59346 |
2.6.0.1 |
|
Wrong com.crossworlds.DataHandlers.cwxml generated by the Adapter Framework |
44746 |
2.6.0.1 |
|
Print the Adapter Framework version |
WBI Toolset changes
Problem tracking numbers |
As of Version |
Problem |
35232 |
4.3.0.2 |
Problem with trace/log files when Locale is French. |
70818 |
4.3.0.2 |
4.2.2.5 Connector Configurator flattens hierarchical configuration files. |
71926 |
4.3.0.2 |
Connector Designer 4225 issues with HTTP Connector 1.0. |
45463 |
4.3.0.2 |
Connector Configurator won't load customers' template for the 2nd time. |
73167 |
4.3.0.2 |
HCG_BIDI: No support for WAS broker in Connector Configurator. |
72221 |
4.3.0.2 |
Appended connector-specific property disappeared after 4.3.0.1 upgrade. |
73888 |
4.3.0.2 |
ConnectorConfigurator slow loading BO. |
66879 |
4.3.0.2 |
Test Connector problem with the Child BO <CxIgrone> Display. |
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 |
Prerequisites
You must have WBI Adapter Framework version 2.6.0 and/or Toolset installed in order to install this fix pack.
Installing the fix pack
1. Ensure that Adapter Framework 2.6.0 is installed and note the install directory.
2. Download the fix pack zip or tar file and unzip or untar the file to a local directory
3. Run the fix pack Installer corresponding to the operating system:
- Windows – setupwin32.exe
- Linux – setupLinux.bin
- AIX– setupAIX.bin
- HP UX – setupHP.bin
- Solaris – setupSolarisSapc.bin
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.
Please refer to the Installer technical notes for instructions on installing Adapter Framework 2.6.0.5 or later on Solaris10.
Please refer to the Installer technical notes for instructions on installing Adapter Framework 2.6.0.5 or later on Red Hat Enterprise Linux 4.0.
Note: You can record the options you select when installing for subsequent silent installations. For more information see Installing silently.
4. Follow Installer wizard prompts to complete installation of the Adapter Framework fix pack. Note that the Installer will end or not proceed if any of the following occurs:
Declining the licensing agreement.
Installing on a Windows platform and you do not have administrative privileges, or if your user login exceeds 20 characters.
Providing a Destination directory name that is not also the installation directory for Adapter Framework 2.6.0
Not providing sufficient free disk space (Windows 300 Mb, All Unix platforms 150 Mb)
5. During fix pack installation, you may be prompted to overwrite existing files. To successfully install the fix pack, you must select Yes to All.
Windows registry entries
After installation on Windows systems, the fix pack Installer updates a registry folder under HKEY_LOCAL_MACHINE\SOFTWARE\IBM\WebSphere Business Integration.
Installing silently
1. Launch the fix pack Installer using the following command:
<install launcher executable> -options-record<install_settings_filename>
For example, on Windows systems: you enter
setupwin32.exe –options-record mySettings.txt
2. Edit the file containing your settings (for example, mySettings.txt) by adding the following lines to the end of the file:
–G replaceExistingResponse=”yesToAll”
–G replaceNewerResponse=”yesToAll”
–G createDirectoryResponse=”yes”
–G removeExistingResponse=”yesToAll”
–G removeModifiedResponse=”yesToAll”
For an example, see the settings.txt file bundled with the fix pack Installer.
3. To silently install, launch the fix pack Installer as follows:
<install launcher executable> -silent-options<install_settings_filename>
For example:
setupwin32.exe –silent-options mySettings.txt
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 |
5724G92J020600.sys |
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:Solaris:AIX:HP_UX :Linux |
Remove |
lib/xwbase.jar, lib/xworacle.jar, lib/xwsqlserver.jar, lib/xwutil.jar |
Win32 |
Replace |
bin/cwservice.exe |
Win32 |
Replace |
bin/start_adapter.bat |
Win32 |
Replace |
bin/start_connector.bat |
Win32 |
Replace |
bin/CWSharedRuntimeEnv.bat |
Win32 |
Replace |
bin/ODKRuntimeEnv.bat |
Solaris:AIX:HP_UX :Linux |
Replace |
bin/adapterEnv.sh |
Solaris:AIX:HP_UX :Linux |
Replace |
bin/start_adapter.sh |
Solaris:AIX:HP_UX :Linux |
Replace |
bin/connector_manager |
Solaris:AIX:HP_UX
:Linux |
Replace |
bin/CWSharedEnv.sh |
Solaris:AIX:HP_UX
:Linux |
Replace |
bin/ODKRuntimeEnv.sh |
Win32:Solaris:AIX:HP_UX :Linux |
Replace |
AdapterJRE/ (whole Dir) |
Win32:Solaris:AIX:HP_UX :Linux |
Add/Replace |
jdk/ (whole Dir) |
Win32 |
Replace |
bin/CwConnector.dll |
Solaris |
Replace |
lib/libCwConnector.so |
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 |
Software |
Version and patch |
Support From Version |
Comments |
Operating system |
|||
Windows XP |
Service Pack 2 |
2.6.0.3 |
Supported only for development CR71584 |
Windows 2003 |
|
2.6.0.3 |
Tools have limited
support on Windows 2003. Please refer to Technote
below: |
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 |
|
Update 4 |
2.6.0.4 |
|
|
RHEL 4.0 ES RHEL 4.0 AS RHEL 4.0 WS |
|
2.6.0.5 |
CR59604 |
SUSE Linux
Enterprise Server(ES) SUSE Linux Standard Server(SS) |
9.0 |
2.6.0.3 |
CR59606 |
Solaris |
10 |
2.6.0.5 |
CR59605 |
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 |
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 |
2.6.0.4 |
|
||
5.0 CSD07 |
2.6.0.5 |
|
|
2.6.0.4 |
CR67721 |
||
WebSphere InterChange Server |
4.3.0.1 |
2.6.0.3 |
|
4.3.0.2 |
2.6.0.4 |
|
|
4.3.0.3 |
2.6.0.6 |
|
|
4.3.0.4 |
2.6.0.5 |
|
|
Websphere Process Server |
6.0 |
2.6.0.3 |
|
6.0.1 |
2.6.0.5 |
|
|
Websphere Enterprise Service Bus |
6.0.1 |
2.6.0.5 |
There are some known issues to configure ESB as broker. 1. Missing one java library file in ESB, WBIAdapterRuntime.jar. 2. Can't manage WBI Adapter on ESB Admin Console. Please contact ESB supporting team for more information. |
Other softwares |
|||
IBM WebSphere
MQ Server and Client |
5.3.0.2 with CSD08 and CSD10 |
2.6.0.3 |
CR71901 |
5.3.0.2 with CSD12 |
2.6.0.5 |
|
|
CR66891 Only for standalone adapters. |
|||
6.0.1.0 |
2.6.0.5 |
|
|
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 |
1.4.2 SR6 |
2.6.0.7 |
|
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.
2. 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.
3. 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>
4. AIX 5.3 supporting:
WebSphere Business Integration Adapter Framework has supported AIX 5.3 since version 2.6.0.2.
5. 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"/>
6. 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
7. Adapter Framework backed-out message processing function (CR72029):
Command line parameter ‘CheckRedelivered’ is incorporated to indicate Adapter Framework how to handle redelivered message.
-xCheckRedelivered=<Threshold>
<Threshold> should be zero or positive number. The Adapter Framework will try to process messages up to that number of times before put them to fault queue.
- Default value is 1, which makes Adapter Framework behaviors as before without this parameter.
- Zero value means Adapter Framework will try to process redelivered message instead of putting it to fault queue. Redelivered times will be written to trace file.
- If user give invalid value, Adapter Framework will keep the default value , i.e. 1.
8. To support messages without namespace which from WMQI (CR72313, CR73664):
Command line parameter ‘AFNamespaceAware’ is incorporated to indicate whether XML parser will check namespace.
-xAFNamespaceAware=true or doesn't set //Default. Working with xml message have namespace
-xAFNamespaceAware=false //Working with xml message have not namespace.
Note:
Adapter Framework will not support XML message with namespace and without namespace at same time.
9. To resolve the problem in CR71557, WebSphere InterChange Server V4.3 need to apply fix pack 2 and plus.
10. When broker is Websphere Business Integration Message Broker V6, please follow the original release guide of WBIMB V5 support.
- If migrate from WMQI 2.1 by mqsimigratemsgflows.exe, add parameter "-data" to locate the Workspace. e.g. mqsimigratemsgflows.exe -p <project name> –d "<your message flow files directory>" -data <WBIMB6 directory>\eclipse\workspace
- If migrate from WBIMQ V5, pay attention that queue manager listener default port is 2414 in WBIMB V6, but it is 1414 in WBIMB V5. You may need to change the default port to 1414 to be consistent with WMQ queue manager and adapter configuration, or vice versa.
11. CR45674
The Required property specifies whether a BO attribute must contain a value. If a particular attribute in the business object must contain a value to be able to process the business object data, set the Required property for the attribute to true. Before CR45674 fix, a BO can be processed even its required attributes don’t have values. This is incorrect behavior, it was fixed in CR45674. If a Required attribute doesn’t contain a value, Adapter Framework will try to fill in the default value which is set in BO specification. If there isn’t a default value in BO specification, Adapter Framework will log an error message 17206 to log file and stop to process the BO. For a required attribute, a value should be set by an adapter or a default value should be set in BO specification.
12. To support old and new start retry behavior, a new -x parameter was added.(CR84135)
Add parameter -xMaxStartRetry=n to adapter starting command line
If there isn't -xMaxStartRetry patamater in command line, new behavior will be applied as in AF2.4/2.6 GM version.
If -xMaxStartRetry=-1(or any negative integer number), old behavior will be applied. Adapter will retry to connect controller forever until success.
If -xMaxStartRetry=n(n>=0), Adapter will retry n times to connect controller. The interval time is 1 minute between attempts. For example, if n=10, adapter will retry 10 times in 10 minutes.
Library packages xwbase.jar, xworacle.jar, xwsqlserver.jar and xwutil.jar are expired under <fix_pack_install_location>/lib directory. They are removed because these embedded JDBC drivers are not necessary for adapter framework, neither required for JDBC adapter. To configure JDBC drivers for JDBC adapter, please refer to below link.
In this enhancement, Adapter Framework will wait all working threads to finish current processing before shutting down. A shutting down timeout value will be set when starting an adapter. If any working threads don't finish in the timeout timeframe, AF will stop them forcedly. All in processing message will be put to fault queue after adapter restart. The timeout value is set on adapter starting rather than on adapter stopping by -x parameter.
- Start adapter with timeout parameter value in minutes
connector_manager –start <connect_name> -xShutdownWait=5
- Shutdown adapter
connector_manager -stop|-stopgraceful
If WPS or WAS is broker, NULL value will be converted to CxIgnore when converting BO to XML message. If still want NULL to be converted to Blank when WAS is broker, a new –x parameter should be used.
Add parameter –xNullToBlank to adapter starting command line
-xNullToBlank=false or doesn't set //Default. Convert NULL to CxIgnore
-xNullToBlank=true //Convert NULL to Blank
You can uninstall this fix pack by using an interactive (graphical) tool or silently (using scripts).
To launch the graphical Uninstaller on Windows platforms:
- Choose Start>Settings>Control Panel, double-click Add/Remove Programs, and specify the Adapter Framework or
- Run the following executable: <fix_pack_install_location>_uninst_ Adapter Framework\uninstaller.bin
To launch the graphical Uninstaller on Unix or Linux platforms:
- Run the following:
<fix_pack_install_location>_uninst_ Adapter Framework/uninstaller.bin
After you launch Uninstaller, follow and respond to the prompts presented by the wizard.
To launch a silent uninstall on Windows platforms:
- Run the following executable:
<fix_pack_install_location>_uninst_ Adapter Framework\uninstaller.exe –silent
To launch a silent uninstall on Unix or Linux platforms:
Run the following executable:
<fix_pack_install_location>_uninst_Adapter Framework/uninstaller.bin –silent
© 2007 IBM Corporation. Proprietary and Confidential. All Rights Reserved.