IBM WebSphere Adapter Foundation Classes, version 7.5.0.1 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.5.0.1.
Enhancements
#CRAPARTitleDetails
1103499Extend the Adapter Monitoring Capabilities by Including Event Points for Connection and Authentication to EIS.
Additional event points were introduced in AFC to capture the connection and authentication related events: WBI.JCAAdapter.Connection.SUCCESS, WBI.JCAAdapter.Connection.FAILURE, WBI.JCAAdapter.Connection.LOST, WBI.JCAAdapter.Connection.CLOSE, WBI.JCAAdapter.Authentication.FAILURE
2103559Enterprise metadata discovery code for the adapter should be thread safe.
Cast Iron Runtime requires the adapter to support thread safe Enterprise metadata discovery, for this requirement the adapter implements thread safe EMD.
3102699Extend the DESPI to support XML Types.
Cast Iron Runtime requires the adapter to support XML data types for sending and receiving business objects from adapters, for this requirement the adapter extends the DESPI implementation for support XML types.
Fixes
#CRAPARTitleDetails
1103614Adapter uses Java timer for polling, when JCA timer is not abilable from the container, the adapter polling thread hangs in this situation.
Symptom: The non-daemon Java timer polling thread hangs with WMB runtime, during inbound operation when the JCA timer is not available from the container.
Resolution: When the JCA Timer is not available from the container, the adapter uses the older approach of using the WorkManager to manage and execute the polling thread.
2103512Adapter Inbound throws UnsupportedOperationException on WMB.
Symptom: The startup of the Adapter fails with the UnsupportedOperationException since WMB does not support a JCA timer in its bootstrap context and the Adapter expects one to be available.
Resolution: Adapter catches the UnsupportedOperationException exception and uses the WorkManager to manage and execute the polling thread, when the JCA timer is not available from the container.
3103589Remove the transaction code from EventPersistenceMemoryImpl.
Symptom: EventPersistenceMemoryImpl suspends and resumes the global transaction while the adapter is running with a in-memory persistence configuration, this could potentially affect the performance.
Resolution: Removed the code that performs suspend and resume of the global transaction for the in-memory persistence configuration.
4103584Schema generation should support to set the maxOccurs to a desired number.
Symptom: The schema generator code does not allow to set the value of maxOccurs attribute to the desired number, instead only allows to set 0, 1 or unbounded.
Resolution: The schema generator code is fixed to allow for setting the value of maxOccurs attribute to the desired number.
5103302XML attribute support in DESPI XML.
Symptom: Current XML DESPI implementation does not consider xml attribute for processing.
Resolution: Support provided for processing xml attributes in DESPI XML.
6103539Synchronous BAPI inbound fails in Node level deployment with the lazy BO parsing.
Symptom: SAP adapter throws exception in sync callback in lazy-mode node level deployment. Error is thrown when maxlength annotation is read.
Resolution: This issue is fixed in AFC.
7103796Detect Illegal XML Character property should be visible only for WPS.
Symptom: The detect illegal XML property should be visible only for WPS and not seen on RAD / WMB toolkit.
Resolution: Modified the AFC code such that the EMDUtil class returns null for the DetectIllegalXML property group if the runtime is other than WID.
8103797JDBC Adapter outbound behavior with illegal xml returns ResourceException.
Symptom: JDBC Adapter throws exception when illegal xml character is used during outbound. The detect illegal XML property options does not work as expected. JDBC adapter uses setObject() method to set the string property.
Resolution: The validation of the illegal character is now done on setObject() method of the accesssor too if the parameter is a string.
9103800Perform validation in EMD and runtime for the Inbound properties.
Symptom: EMD allows and accepts negative values for the following AFC properties (Interval between polling periods , Maximum events in polling period, and Time between retries in case of system connection failure).
Resolution: AFC provides a validation for these properties to not accept negative values during EMD and in the runtime.
10103802The AFC version for outbound request should be at FINEST level.
Symptom: The tracing of the AFC version for each individual outbound request should be at FINEST level. Currently, the tracing is done at INFO level which causes a lot of IO and unneccessary logs in high load conditions for each outbound request.
Resolution: The AFC version information is now traced only at the FINEST level.
11103803Use UOWManager as the trasaction API for Event Persistence
Symptom: AFC Event persistence classes are still using the deprecated WAS API. This change is to implement the new WAS API for Transaction handling in Event persistence classes.
Resolution: Modified the Event persistence classes now to use the UOWManager as its transaction API.
12103804Modify getEventWithXid method in AFC EventPersistence.
Symptom: getEventWithXid method is called during the adapter recovery path. This method uses incorrect event peristence column names.
Resolution: Fixed the getEventWithXid method to use the appropriate event persistence column name.


This table lists new and modified connector properties
#VersionAdded or ModifiedPropertyLocation
No connector properties were introduced or modified for this version of the fix pack.


To upgrade to the fix pack version 7.0.0.3, do the following.
1. Ensure that you have followed the "Installation Instructions" section in the download link before proceeding.
2. If you need to use the Fix Pack for EMD, delete the connector project in WebSphere Integration Developer, import the new RAR file, and apply the enterprise information system (EIS) specific dependency files.
   a. Open the Java build path for the SCA module and remove the Connector project that is selected on Projects tab.
   b. Open the dependency editor and remove the connector project.
   c. Delete the connector project from the workspace.
   d. Import the new RAR file. Add any dependency files from EIS specific application-specific information as needed.
   e. Open the Java build path for the SCA module and select the Connector project that is selected on the Projects tab.
   e. Open the dependency editor and add the connector project if it is not already present and select Deploy with Module.
3. If you need to update deployed applications on WebSphere Process Server, do the following:
   a. Select Update for the corresponding application on the WebSphere Process Server administrative console.
   b. Select Single Module with a relative path as name of the RAR file - CWYEM_EMail.rar.
   c. Click Browse on the local file system to select the updated RAR file that has the changes.
   d. Select the default values in the remaining steps and click Finish. This will ensure that existing configurations, for example, are not changed and that only JAR files will be updated.


September 23rd, 2011 6:00 PM
(C) 2011 IBM Corporation. Proprietary and Confidential. All Rights Reserved.