IBM WebSphere WebSphere Adapter for JDE, version 7.5.0.2_IF03 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 interim fix version 7.5.0.2_IF03.
Enhancements
#CRAPARTitleDetails
There are no enhancements in this interim fix.
Fixes
#CRAPARTitleDetails
1Include AFC IFix 7.5.0.2_IF03. Please check AFC Readme for fix details.
Symptom: Include AFC IFix 7.5.0.2_IF03. Please check AFC Readme for fix details.
Resolution:


This table lists the enhancements and fixes in interim fix version 7.5.0.2_IF02.
Enhancements
#CRAPARTitleDetails
There are no enhancements in this interim fix.
Fixes
#CRAPARTitleDetails
1Support for JDE Tools v9.1 - Outbound
Symptom: Support for JDE Tools v9.1 - Outbound.
Resolution: Support added for JDE Tools v9.1 - Outbound only.


This table lists the enhancements and fixes in fix pack version 7.5.0.2.
Enhancements
#CRAPARTitleDetails
There are no enhancements in this fix pack.
Fixes
#CRAPARTitleDetails
1RTC-6293Minimum and maximum properties under "Number of connections for event deilivery" are not seen in EMD screen
Symptom: When UNORDERED delivery is selected, Minimum and maximum properties under "Number of connections for event deilivery" are not seen in EMD screen.
Resolution: Removed support for UNORDERED delivery.
2RTC-6503User name and password fields are empty in "deployment properties screen" for outbound scenario
Symptom: User name and password fields are empty in "deployment properties screen" for outbound scenario. The values entered in discovery properties screen are not carried to deployment properties screen.
Resolution: Fixed by AFC RTC-6694. See AFC Readme.
3RTC-6774JDE Adapter failing to validate the timeout property properly in deployment properties screen
Symptom: JDE Adapter failing to validate the timeout property properly in deployment properties screen. A positive long value higher than MAX_INT can get cast to a negative integer and result in execptions at runtime.
Resolution: Updated JDEOutboundConnectionConfiguration and JDEMetadataSelection classes to allow values in the range 0 to MAX_INT only in the timeout properties during EMD.
4RTC-6860JDE adapter is polling for all the events in JDE server irrespective of BO mapped during the EMD step
Symptom: When JDE adapter receives an event which is not configured through EMD, it throws a NullPointerException since the BO definition for that event could not be found.
Resolution: Updated the adapter to throw ResourceException when BO definition could not be found.
5RTC-6881NullPointerException seen in .log after Discovery
Symptom: NullPointerException seen in .log after Discovery
Resolution: Added null check and corrected the property name used to lookup XMLLists property element in JDEFilterPG.
6RTC-7033JDE adapter is not deleting the events which are 1 with XID entry which may lead to performance issue
Symptom: If the server is terminated while event processing is in progress, any entries with status 1 are left undeleted from the event table. When event processing resumes after server is restarted, the event entries remain in the event table.
Resolution: Updated JDEEventStoreWithXid to include events already existing in event table (but received from EIS once again as the events were not acknowledged when they were processed in the previous run) for deletion.
7RTC-7038JDE server connection leak in JDEInboundHandlerWithXid
Symptom: When an instance of JDEInboundHandlerWithXid is created, a failure to create a sync event session can result in connection to JDE server not logged off. The connection is logged off only when close() is called on the instance. But then an exception thrown by the constructor leaves no chance to call close() thus leading to connection leaks.
Resolution: Updated JDEInboundHandlerWithXid to logoff connection when SyncEventSession creation fails.


This table lists the enhancements and fixes in fix pack version 7.5.0.1.
Enhancements
#CRAPARTitleDetails
There are no enhancements in this fix pack.
Fixes
#CRAPARTitleDetails
1103499JR40937Password getting displayed for Connection_Id parameter in the trace logs
Symptom: Password getting displayed for Connection_Id parameter in the trace logs
Resolution: Removed password from the Connection_Id
2103593JR40938JDE Adapter inbound scenario failing with WMB
Symptom: JDE Adapter inbound scenario failing with WMB due to exceptions Caused by: java.lang.ClassNotFoundException: com.ibm.websphere.sca.sdo.DataFactory. JDE code is checking whether it is SDOV1 or SDOV2 while creating the data object.
Resolution: Checking of SDO version is delegated to AFC code while creating the data object.
3103499JR40939For Wrong credentials "AUTHENTICATION" Failure is not getting captured in trace log
Symptom: When wrong credentials are provided AUTHENTICATION Failure is not getting captured in trace logs. Also, CONNECTION closed should not be reported as there is no connectoion is established.
Resolution: Changed JDEResourceAdapter.isAuthenticationFailure() to recognize com.jdedwards.system.connector.dynamic.InvalidLoginException as authentication failed exception. Changed the connection retry behaviour not to attempt retries in case of authentication failure.
4103593JR40940Not reporting any event status in trace logs for authentication failure,connection lost and connection failure for inbound scenario.
Symptom: Not reporting any event status in trace logs for authentication failure,connection lost and connection failure for inbound scenario.
Resolution: Changed JDEInboundHandlerWithXid.createSyncEventSession() to catch ApplicationExceptions and log authentication failures
5103593JR40943Message flow is getting deployed successfully in to the broker when provided wrong crendentials for inbound scenario
Symptom: Message flow deployment in to the broker is successful when we provided wrong crendentials for inbound scenario.
Resolution: In case of authentication failure in inbound scenario, wrapping of JDE ApplicationException in AuthenticationFailException results in deployment to succeed. Throwing the original exception as is after logging fails the deploymentm which is the expected behavior.
6103593JR40944Reporting wrong event status when provided wrong credentials for inbound scenario.
Symptom: Reporting wrong event status when provided wrong credentials for inbound scenario. It should report authentication failure and connection failure as event status not authentication failure and connection lost as event status.
Resolution: Throw the original JDE ApplicationException as is to prevent connection lost getting logged incorrectly.
7103593JR40945Not Reporting any connection related event status for "connection failure" and "connection Lost" in inbound scenario
Symptom: Not Reporting any connection related event status for connection failure and connection Lost in inbound scenario.
Resolution: Updated JDEInboundHandlerWithXid and JDEEventStoreWithXid to emit a connection event in case of connection loss.
8103593JR40946Message flow is getting deployed successfully in to the broker when there is connection failure and Lost for inbound scenario
Symptom: Message flow deployment in to the broker is successful when there is connection failure and connection Lost for inbound scenario.
Resolution: Changed the default value of the property retryConnectionOnStartup to false.
9JR40947Errors are caused when building the project after running EMD for inbound scenario.
Symptom: Errors are caused when building the project after running EMD for inbound scenario.
Resolution: Changed JDERTEDataDescription.getCardinality() to return "1" instead of "RTE".
10JR40974Runtime errors occured for JDE inbound and SAP outbound mediation flow scenario in WPS7.5
Symptom: Runtime errors occured for JDE inbound and SAP outbound mediation flow scenario in WPS7.5. Throws "org.xml.sax.SAXNotRecognizedException: Feature 'http://apache.org/xml/features/xinclude' is not recognized" due to xerces dependency jar required by the adapter.
Resolution: Setting the property "org.apache.xerces.xni.parser.XMLParserConfiguration=org.apache.xerces.parsers.XIncludeAwareParserConfiguration" in jre/lib/xerces.properties in the WPS' java runtime directory removes the SAXNotRecognizedException exception.


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


To upgrade to the interim fix version 7.5.0.2_IF03, 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 (WID), 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.
   f. Open the dependency editor and add the connector project if it is not already present.
3. If you need to update deployed applications using embedded adapter on WebSphere Process Server (WPS) or WebSphere Enterprise Service Bus (ESB), do the following:
   a. Select Update for the corresponding application on the WPS or ESB administrative console.
   b. Select Single Module with a relative path as name of the RAR file - CWYBC_JDE.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.
4. If you need to update deployed applications using stand-alone adapter on WPS or ESB, do the following:
   a. Stop all deployed applications using the stand-alone adapter on the WPS or ESB administrative console.
   b. Re-deploy the stand-alone resource adapter with the new RAR.
   c. Re-deploy all the applications using stand-alone adapter.


August 8, 2012 6:00 PM
(C) Copyright 2011 IBM Corporation