IBM WebSphere Adapter for Siebel Business Application, version 7.0.0.4 notes

This document contains the following sections:
Enhancements and fixes
New and modified connector properties
Upgrade notes
This table lists the enhancements and fixes in fix pack version 7.0.0.4.
Enhancements
# CR APAR Title Details
1 103263 Handling business errors with fault.
Symptom: In WPS, adapter doesn't handle business error from Siebel server as fault. User cannot use BPEL to handle these business errors.
Resolution: Add a new fault "InvalidRequestFault" for Siebel Exception.
Fixes
# CR APAR Title Details
1 103356 JR39485 Some field values are missed in "association" child BCs.
Symptom: Some field values in child BOs are missed in runtime. Those child BOs have "association" relationship with their parent BOs.
Resolution: Activate those fields and perform query again in child BOs.
2 103246 JR39237 SIEBEL ADAPTER IGNORES FIELD VALUE WITH SBL-DAT.
Symptom: Siebel adapter ignores fields which contains string 'SBL-DAT' in repsonse message.
Resolution: Fix the problem by removing the extra checking.
3 102143 XML character filter set in EMD will not take effect for first time in outbound assigned.
Symptom: XML character filter set properties in EMD will not take effect, if you select option B or C, it will always be A after EMD.
Resolution: Fix the code to preserve the selection in EMD.
4 103319 JR39417 Invalid request conversion of array type in BS.
Symptom: Send multiple/array request in business service, but adapter only has one response.
Resolution: Change the request structure of business service to fix the problem.
5 102343 JR38016 Siebel Adapter creates null as data type.
Symptom: Siebel Adapter creates null as data type for some arguments of business services after metadata discovery.
Resolution: "Inactive" integration objects(IOs) causes this problem. Filter out "inactive" IOs during the metadata discovery to fix this problem.
6 103383 JR36907 FwdFix. Missing empty string handling for request and response in business services.
Symptom: Adapter ignores fields with empty string value in both request and response of business services calls.
Resolution:
1. Added empty string value handling in business services request part.
2. Added a property includeEmptyFields in MCF to determine whether adapter returns empty string fields in response BO. Activate this feature by setting the property to true.
7 102341 JR38003 Connection lost if resonate support throws exception
Symptom: If Siebel adapter is active and is idle for a long time(resonateSupport = true), then an error will be thrown in the next attempt of connection.
Resolution: Make a login call if attach call is failed for this scenario.
8 102613 JR38019 Enable JCA timer capability for inbound polling
Symptom: Adapter uses a polling thread in the runtime, which will poll as per the pollperiod. The polling thread will be only submitted once and always being in the runtime environment. When there are no events for a longer duration, the polling thread will be hung and throws a warning message from the JCA container.
Resolution: Use JCA timer to schedule the polling thread, so the polling thread would be submitted according to the JCA scheduler, which will solve the thread hang issue.
9 JR39773 Inbound polling fails on WebSphere Message Broker (WMB) throwing java.lang.UnsupportedOperationException.
Symptom: Adapter fails during startup of the Inbound polling on WebSphere Message Broker. Adapter throws java.lang.UnsupportedOperationException will be thrown during the call to BootStrapContext.createTimer()
Resolution: WMB currently does not return a timer in createTimer() call. The issue has been resolved by handling the exception at the adapter end and creating a java.util.Timer instance to handle the inbound polling.


This table lists the enhancements and fixes in fix pack version 7.0.0.3.
Enhancements
# CR APAR Title Details
There are no enhancements in this fix pack.
Fixes
# CR APAR Title Details
1 93563 Null BO getting generated in inbound runtime.
Symptom: Some extra null BOs and fields are returned in the inbound processing of business service.
Resolution: Fix the convertion problem between SiebelPropertySet, which is returned by business service, and BO.
2 93554 JR35750 Some field values are missed in child BOs with "simpleLink" relationship.
Symptom: Some field value in child BOs are missed in runtime. Those child BOs have "simplelink" relationship with their parent BOs.
Resolution: Activate all fields in child BOs before all field values retrieval.


This table lists the enhancements and fixes in fix pack version 7.0.0.1.
Enhancements
# CR APAR Title Details
There are no enhancements in this fix pack.
Fixes
# CR APAR Title Details
1 77930 Printing out the AdapterFoundationClasses version in the Logs/traces.
Symptom: Currently with all the adapters , The AFC version is not printed out in the logs/traces. It would be really helpful to have this information printed out to the logs/traces especially in debugging issues due to conflicting AFC being loaded at runtime.
Resolution: print AFC version in the trace
2 99888 Change to use PmiRmJmxService MBean to get arm transaction factory name.
Symptom: When adapter gets ARM transaction factory name to process ARM transaction, a WAS internal private API is used for it, which need to be replaced with public interfaces.
Resolution: Switched to Invoke PmiRmJmxService MBean, a set of public interfaces exposed by WAS to get ARM transaction fatory name.
3 100262 Ambiguous semantics of the max connection number in the event delivery config
Symptom: Adapter will not use connection pool for event delivery if max connection number is 1 and delivery mode is "UNORDERED". In this situation, multiple thread will share one connection without thread safe mechanism, which will cause exception.
Resolution: The fix makes connection pool be used when max connection number is 1, connection pool keep thread safe and thus is recommended to use under "UNORDERED" and "ORDERED BY KEY" delivery mode; If user preferred not to use connection pool, he/she could set max connection number to 0, while thread safe will not be guaranteed.
4 100356 When BO name is same and BO namespace is different, inbound work may be failed.
Symptom: When adapter creates 2 or more different modules with BO having same name but different namespace and structure, inbound and outbound operations of those modules will throw NullPointerException.
Resolution: Redefined the methods of "hashCode()" and "equals()" in the SDOV1Type class. Then individual adapter can distinguish those BO correctly by "namespace + name" if those BOs name are equal.
5 100406 Adapter will encoutner NPE after restart the app on server!
Symptom: For Adapter inbound and outbound operation(standalone deployment), after the application is restarted, the NullPointerException will appear when the adapter tries to query the ASI Infor from cache.
Resolution: The BO's namespace and name has been preserved as BO instance's fields. After the application is restarted, adapter can still get them from those instance's field rather than the stale data cache.
6 100419 BS shortname: If the name of IO and IC is the same, one xsd will be overwritten.
Symptom: When the name of Integration object (IO) and Integration Component (IC), the schema file for service binding will missed after EMD.
Resolution: Add a prefix "BS" for schema file if generated file has same file name.
7 100420 NPE will be thrown if we choose same inputs across different method in EMD.
Symptom: During EMD, NullPointerException will ocurr if an integration object (IO) has been chosen as input for several times.
Resolution: Add a filter to handle duplicated IO selections.
8 100421 If the primary key in Legacy adapter is not "Id", runtime will fail.
Symptom: If primary key field in WBIA adapter project is not the same as EIS side, runtime will have error after migration to JCA.
Resolution: Retrieve the name of primary key field from ASI, just like normal fields do.
9 100430 Memory leak in WAS Inbound with BeanType.
Symptom: When adapter caches some BeanTypes that have a great deal of properties, java OutOfMemmory Exception be thrown during performing inbound and outbound operation with some events (persisting 20-50 times in WAS broker).
Resolution: When adapter creates 2 or more different modules with BO having same name but different namespace and structure, inbound and outbound operations of those modules will throw NullPointerException.


This table lists new connector properties
# Version Platform Add or Remove Property (Note that property names are case sensitive)
There is no new connector property introduced/modified for this version of fix pack.


To upgrade to the fix pack version 7.0.0.4, do the following:
1. Ensure you have followed the 'Installation Instructions' section in the download link before proceeding further.
2. If you need to use the Fix Pack for EMD, delete the connector project in the WebSphere Integration Developer (WID), import the new rar and apply the EIS specific dependency files. The following steps describe how to do the same.
   a. Open the Java Build Path for the SCA module and remove the Connector project selected on projects tab.
   b. Open the dependency editor and remove the connector project.
   c. Delete the connector project from workspace.
   d. Import the new rar file. Add any dependency files from EIS specific APIs as needed.
   e. Open Java build path for the SCA module and select the Connector project selected on projects tab.
   f. Open the dependency editor and add the connector project if it is not already present and check "Deploy with Module".
3. To update deployed applications(that have an embedded adapter RAR file) on the WebSphere Process Server (WPS),use the following procedure
   a. Stop the application that needs to be updated,using the WPS administrative console
   b. Select Update for the corresponding application in the WPS administriative Console.
   c. Select Replace or add a single file option with relative path as name of the rar file - CWYES_SiebelAdapter.rar.
   d. Click the Browse button to select the updated RAR file on your local file system.
   e. Select the default values for the consecutive steps and select Finish.This will ensure that existing configurations e.g. MCF,are not changed and the JAR files are only updated.
4. To upgrade to this Interim fix version on Websphere Message Broker (WMB) runtime, do the following :
   a. Stop all your Broker(s) that are using old adapter build.
   b. Unzip the CWYES_SiebelAdapter.rar to your temporary directory. It should contain the files CWYEB_SiebelAdapter.jar and CWYBS_AdapterFoundation.jar.
   c. Backup original jar files CWYEB_SiebelAdapter.jar and CWYBS_AdapterFoundation.jar in MQSI_INSTALL_PATH/adapters/prereqs/jars directory to another directory, where MQSI_INSTALL_PATH is WMB runtime install path. (e.g. /opt/ibm/mqsi/7.0/)
   d. Copy new CWYEB_SiebelAdapter.jar and CWYBS_AdapterFoundation.jar from your temporary directory to MQSI_INSTALL_PATH/adapters/prereqs/jars
   e. Restart your Broker(s).
5. To upgrade to this interim fix version on Websphere Message Broker Toolkit (WMBT), you have two options:
   a. Create a new folder "Siebel_" with version_number under WMBT_INSTALL_PATH/ResourceAdapters directory, where WMBT_INSTALL_PATH is WMBT runtime install path. (e.g. C:\Program Files\IBM\WMBT70).
   b. Copy new CWYEB_SiebelAdapter.rar to above directory.
   c. Restart WMBT.



8th July, 2011 6:00 PM
(C) 2011 IBM Corporation. Proprietary and Confidential. All Rights Reserved.