IBM WebSphere Business Integration Adapter for mySAP.com, version 5.5.x notes

This document contains the following sections:
Enhancements and fixes
New and modified connector properties
Files added, changed, and modified
Upgrade notes

This table lists the enhancements and fixes in fix pack version 5.5.7.
Enhancements
#CRAPARTitleDetails
There are no enhancements in this fix pack.
Fixes
#CRAPARTitleDetails
187499JR24595ALE Module
Symptom: Adapter for SAP does not generate an appropriate message if when it goes down during recovery.
Resolution: Logging has been updated. Now the Adapter generates a proper message during recovery.
287885BAPI Module
Symptom: The adapter does not restart when an RFC_ERROR_SYSTEM_FAILURE error occurs.
Resolution: The adapter automatically restarts when this error occurs.
387849SAP ODA
Symptom: SAPODA Fails to load the BOR Tree when connected to ERP'05 System.
Resolution: With this fix, the SAP ODA can successfully load the BOR tree in the Business Object Designer after connecting to ERP'05 system.
468077JR23566ODA
Symptom: In the BO Designer, when the user selects BOR (Business Object Repository) Node to create new business object with SAP ODA, a blank error window is displayed without any message.
Resolution: With this fix, the ODA can expand the BOR node and objects can be generated.
582999JR23060ALE Module
Symptom: When using the ALE Module for request processing, if the "RfcProgramId" configuration property is not set, adapter throws a null pointer exception if it is terminated by pressing the 'q' key.
Resolution: With this fix, terminating the adapter will not cause any errors or exceptions.
667574JR22614All Modules
Symptom: An RFC_ERROR_LOGON_FAILURE: A timeout problem occurs when using the ALE module.
Resolution: During request processing, connector was restarting for recoverable JCo errors. With this fix, the connector restarts only for nonrecoverable JCo exceptions. For non fatal JCO errors it will only fail the request.
773643JR22883ALE Module
Symptom: A message is stuck in the event queue and getting processed multiple times.
Resolution: Duplicate event elimination is supported with this fix. To enable it, set the DuplicateEventElimination standard configuration property to true. When this property is set to true, a JMS-enabled connector can ensure that duplicate events are not delivered to the delivery queue. Also, create a new MQ queue called MONITORQUEUE to set the MonitorQueue standard configuration property. Note that a unique value is set for the objectEventId attribute in the corresponding Business Object instance.
870697Extension module
Symptom: In SAP Adapter ALE Extension module, whenever an event fails in a poll cycle, Adapter keeps such event in the event table with a status of R, instead of archiving it as a failure.
Resolution: With this fix, the failed events are archived with a failure status.


This table lists the enhancements and fixes in fix pack version 5.5.6.
Enhancements
#CRAPARTitleDetails
There are no enhancements in this fix pack.
Fixes
#CRAPARTitleDetails
160220JR21157ODA
Symptom: The ODA was failing to create business objects that contain the same structure in the import and export fields.
Resolution: With this fix, the structures are uniquely renamed and the object is created successfully.
259037JR21157ALE Module
Symptom: When the Dummy_key attribute does not exist in the business object, the adapter would fail.
Resolution: With this fix, the adapter will process the event successfully without dummy_key mapping.
345003JR21157ALE Module
Symptom: When the connector is paused, events were sent to the error queue.
Resolution: With this fix, the events will remain in the event queue to be reprocessed again when the connector becomes un-paused again.


This table lists the enhancements and fixes in fix pack version 5.5.5.
Enhancements
#CRAPARTitleDetails
144697JR20670ALL
Symptom: Customer want MS932(Japanese) be supported!
Resolution: Support for MS932, Japanese characters is now supported. The new configuration property, PartnerCharset must be used to specify the PartnerCharset encoding.
237323JR20575Extension Module
Symptom: If the SAP adapter is pausing (during polling), events in status 'R' from the current events table goes to status '3' in archived events table and are not processed anymore.
Resolution: Events sent when the connector is paused no longer go to the Archive Table with Status ‘3’. They remain in the Event Table ready to be polled with a status of ‘Q’. This change requires importing transports from the following files, 4_Delivery.zip and 4_Utilities.zip.
Fixes
#CRAPARTitleDetails
160078JR20575ALE Module
Symptom: SAP adapter hangs after sending BO with CR LF characters.
Resolution: The adapter no longer hangs after sending a business object with CR LF characters.
260038JR20575Extension Module
Symptom: Customer getting an error on Event Linkage on SAP 4.7 system.
Resolution: The Event Linkage mechanism will work on the SAP 4.7 system with this fix. This change requires importing transports in 47_EventTriggering.zip file.
344080JR20575ALE Module
Symptom: When the adapter is paused some events disappeared.
Resolution: With this fix, all events are accounted for in the event queue.
437455JR20575ALE Module
Symptom: Processing IDOCs with empty text segment gives problems
Resolution: When processing IDOCs with an empty text segment the adapter will not longer fail with an MQ error.


This table lists the enhancements and fixes in fix pack version 5.5.4.
Enhancements
#CRAPARTitleDetails
There are no enhancements in this fix pack.
Fixes
#CRAPARTitleDetails
159080JR20290RFCServer Module
Symptom: SAP adapter in RFCServer Module is going down in receiving an invalid response.
Resolution: SAP Adapter RfcServer no longer terminates when an invalid response message is received from WebSphere Message Broker.
258858JR20290ALE Module
Symptom: NullPointerException in case of wrong control record data (SAP ALE).
Resolution: SAP Adapter no longer throws the NullPointerException in case of wrong control record data (SAP ALE).
358954JR20265RFC Server Module
Symptom: RFCServer Module is going down when an unsubscribed RFC is triggered from SAP.
Resolution: If a BO is not supported, do not terminate the adapter, rather, log an error and keep the adapter alive.
437005JR20265Extension Module
Symptom: When upgrading the SAP adapter from 5.0 to 5.5 the extension module is not working.
Resolution: Correct processing of child BOs when using the ABAP BAPI_Handler.
558492JR20232ALL
Symptom: SAPConnector fails to restart upon going down.
Resolution: The restart/retry feature was not restarting the connector correctly. This needs to be implemented in conjuction with an adapter framework fix. Contact WBI Technical Support for information on the adapter framework fix.


This table lists the enhancements and fixes in fix pack version 5.5.3.
Enhancements
#CRAPARTitleDetails
There are no enhancements in this fix pack.
Fixes
#CRAPARTitleDetails
135192JR20092ALE Module
Symptom: Archiving/removing of events from Request directory.
Resolution: Performance was degrading when the Request directory fills up with many status files for ALE request processing.
236006JR20092ALE Module
Symptom: SAP adapter fix pack 5.5.2 initialization not pickup AleEventDir.
Resolution: Adapter was not using the configured connector property value for "AleEventDir" for creating the "Request" folder. Request folder holds the status message files for ALE request processing using TID management. NOTE: Before applying this patch, complete all of your failed ALE Request flows. After applying this patch the connector creates and uses the "Request" folder under the configured parent directory. It will no longer cleanup the previous request directory. You will have to manually cleanup that directory.
335673JR20092ODA
Symptom: SAP ODA generate APSI=0 if input is SAP4.7 IDOC file.
Resolution: When using IDOC files from SAP R/3 4.7 systems, the Application Specific information generated in the business objects was incorrect. This is due to the fact that, the ODA looks for "BYTE_FIRST" property of the IDOC file to get the begin index of the field. Since the BYTE_ prefix is replaced with that of CHARACTER_, the ODA could not identify the begin index and hence you find 0 in ASI. This is now fixed in the SAPODA.
442920JR20092ODA
Symptom: The SAP ODA cannot generate BO correctly.
Resolution: A Search By Description BAPI/RFC down the RFC node was not generating its corresponding BO correctly.Code change has been made in Kirkwood patch and fixed in this release.
535387JR20092ALE Module
Symptom: Zero like characters getting appended to the data in SAP, using latest adapter.
Resolution: Correct the setting of the space characters that pad the fields in a segment when sending it to SAP.


This table lists the enhancements and fixes in fix pack version 5.5.2.
Enhancements
#CRAPARTitleDetails
134614JR19942ALL
Symptom: SAPAdapter throws misleading error when MQJMS libraries are not installed.
Resolution: During startup SAPAdapter logs misleading error saying "JCO files missing" when MQ JMS libraries are not installed.The connector now logs proper message.
Fixes
#CRAPARTitleDetails
134205JR19928ALE Module
Symptom: Based on network error, upon loosing connection to SAP application, SAP Connector does not go down completely
Resolution: When SAP server shuts down abruptly request events are no longer lost during request processing.


This table lists the enhancements and fixes in fix pack version 5.5.1.
Enhancements
#CRAPARTitleDetails
There are no enhancements in this fix pack.
Fixes
#CRAPARTitleDetails
133144JR19534Extension Module
Symptom: ObjectEventId set to CxIgnore in the response BO.
Resolution: The value of ObjectEventId is preserved for request processing.
232731JR19534ALL
Symptom: 5.4.4 version of Adapter does not start with ICS 4.1.1.
Resolution: Configuration properties are case-insensitive beginning with ICS version 4.2.0 and WBIA 2.3.0.
331502JR19375ALE Module
Symptom: restart behaivor after application is getting lost.
Resolution: When the connector dies due to a Fatal Error, the RestartRetryCount connector property will properly restart the connector.


This table lists new connector properties
#VersionPlatformAdd or RemoveProperty (Note that property names are case sensitive)
15.5.7WIN, UNIXAddDuplicateEventElimination
25.5.6nonenonenone
35.5.5WIN, UNIXAddPartnerCharset
45.5.5WIN, UNIXAddArchiveUnsubEvents
55.5.4nonenonenone
65.5.3nonenonenone
75.5.2nonenonenone
85.5.1nonenonenone


This table lists new or changed files
#VersionPlatformAdd or Remove or ReplaceFile (Starting from %INSTALLDIR% directory)
15.5.7WIN, UNIXReplace\ODA\SAP\SAPODA.jar
25.5.7WIN, UNIXReplace\connectors\messages\SAPConnector.txt
35.5.7WIN, UNIXReplace\connectors\SAP\CWSAP.jar
45.5.7WIN, UNIXReplace\repository\SAP\CN_SAP.txt
55.5.7WIN, UNIXReplace\connectors\SAP\dependencies\transports_4x\4_Delivery.zip
65.5.7WIN, UNIXReplace\connectors\SAP\dependencies\transports_4x\SAP4_Transports.txt
75.5.7WIN, UNIXReplace \connectors\SAP\dependencies\transports_4x\47_EventTriggering.zip
85.5.7WIN, UNIXReplace\connectors\SAP\dependencies\transports_4x\4_Utilities.zip
95.5.6WIN, UNIXReplace\connectors\messages\SAPConnector.txt
105.5.6WIN, UNIXReplace\connectors\SAP\CWSAP.jar
115.5.5WIN, UNIXReplace\connectors\SAP\dependencies\transports_4x\SAP4_Transports.txt
125.5.5WIN, UNIXReplace \connectors\SAP\dependencies\transports_4x\47_EventTriggering.zip
135.5.5WIN, UNIXReplace\connectors\SAP\dependencies\transports_4x\4_Utilities.zip
145.5.5WIN, UNIXReplace\connectors\SAP\dependencies\transports_4x\4_Delivery.zip
155.5.5WIN, UNIXReplace\ODA\SAP\SAPODA.jar
165.5.5WIN, UNIXReplace\connectors\SAP\CWSAP.jar
175.5.5WIN, UNIXReplace\connectors\messages\SAPConnector.txt
185.5.5WIN, UNIXReplace\repository\SAP\CN_SAP.txt
195.5.4WIN, UNIXReplace\ODA\SAP\SAPODA.jar
205.5.4WIN, UNIXReplace\connectors\SAP\CWSAP.jar
215.5.4WIN, UNIXReplace\connectors\messages\SAPConnector.txt
225.5.3WIN, UNIXReplace\ODA\SAP\SAPODA.jar
235.5.3WIN, UNIXReplace\connectors\SAP\CWSAP.jar
245.5.3WIN, UNIXReplace\connectors\messages\SAPConnector.txt
255.5.2WIN, UNIXReplace\connectors\SAP\CWSAP.jar
265.5.2WIN, UNIXReplace\connectors\messages\SAPConnector.txt
275.5.1WIN, UNIXReplace\connectors\SAP\CWSAP.jar


Upgrade notes
For new version 5.5.7, use SAPJCO version 2.1.8
A new queue management utility helps manage the new queues in version 5.3.2. It is available on Windows. Please see BIA_AleEventUtil_readme.txt for information and usage of the utility.
To upgrade the Ale Module from version 4.8.1 and earlier or version 5.0.0 to 5.3.3 or later:
This version of the adapter manages ALE transaction id's and IDocs using MQ Series. As a result, it is imperative that you allow the current IDoc processing cycle to complete before applying this patch. Temporarily halt the transmission of IDocs both to and from the adapter and verify that there are no IDocs (files) in the following directories when you upgrade: - CrossWorlds\connectors\SAP\ale\events - CrossWorlds\connectors\SAP\ale\wip Also verify that any failed or unsubscribed IDocs (files) in the following directory have been reviewed, corrected and re-processed: - CrossWorlds\connectors\SAP\ale\archive Once all IDocs (files) complete successfully, apply the upgrade and follow the new configuration instructions in the documentation.
Six new queues are needed: - SAPALE_Archive_Queue - SAPALE_Event_Queue - SAPALE_Wip_Queue - SAPALE_Error_Queue - SAPALE_UnSubscribed_Queue - SAPtid_Queue
Also an empty text file called EventState.log is required in the %CROSSWORLDS%\connector\SAP\ALE directory.
For further details, please refer to the adapter guide.
To upgrade the Ale Module for request processing from versions 4.8.2 through 5.2.4 to version 5.3.2 or later: - Process all of your failed events in the SAPTid_Queue. - Clear the messages out of the SAPTid_Queue.
The ArchiveDays connector configuration property determines the number of days when the TIDManagement files should be deleted from the %CROSSWORLDS%\connectors\SAP\ale\request directory. A file is created after an event has been processed successfully. All failed events will remain in the SAPTid_Queue until they are resubmitted again. The default is seven days if no value is given.
TROUBLESHOOTING:
If receiving this error: "Unable to load message catalog - mqji" you may have an invalid value for the AleEventDir Application Specific property. This property should contain the path where you want the EventState.log file to be saved. Be sure not include the filename with the path, like C:\WebSphereAdapters\connector\SAP\ALE\EventState.log, since this will cause the error.
To use the ALE Module to process large IDocs or IDoc Packets: 1. Increase the Maximum Message Length of the MQSeries Queue Manager and its queues. This length defaults to 4194304 bytes. 2. Increase the log file size and the number of log files when you create the Queue Manager. 3. Increase the Maximum Message length of the channel (for remote queues). Refer to the MQSeries System Administration publication for more information on configuring the log files.


April 13th, 2007 6:00 PM
(C) 2006 IBM Corporation. Proprietary and Confidential. All Rights Reserved.