Patch Notes for
Version 5.2.5 of the IBM WebSphere Business Integration Adapter for mySAP.com

(for IBM CrossWorlds Infrastructure versions 3.0.1 through 4.1.x.

 


The patch note contains the following sections:

CONNECTOR REVISIONS

UPGRADE INSTRUCTIONS

 


CONNECTOR REVISIONS

This patch contains the following revisions since the last maintenance release:

Available as of Version

APAR Number

CR Number

Feature

Description

5.2.5 JR18205 22476 Rfcserver Module MQ sessions are no longer created if only the Rfcserver module is started.
5.2.5 JR18205 22469 Bapi, Rfcserver Modules The attribute value for the DATE and TIME fields are being set correctly.
5.2.5 JR18205 22406 ALL Improvements have been made when the connector runs in multi-threaded mode.
5.2.5 JR18205 22390 ALE  Module Request processing performance has been improved with this patch.  
5.2.5 JR18205 22073 ALE Module Changes made for service call requests for new versions of JCO.  When running on AIX platforms this patch will fix the core dumps.
5.2.5 JR18205 20328 Extension Module Hierarchy levels greater than 8 are now supported.
5.2.4 JR18066 22314 Rfcserver An additional return code status is checked from the destination application in order for the data to be returned properly.  Also, this fix requires infrastructure patch version 2.1.0.1.
5.2.4 JR18066 22220 ODA The ODA has been enhanced to handle the special characters in the IDoc.
5.2.4 JR18066 20165 ALL Changes have been made to the start_sap.sh script to pass in the library path.  The OAD will now re-start the SAP Connector in Solaris and AIX.  Also, this fix requires infrastructure patch version 4.1.1.6.
5.2.3 JR17956 21328 ODA The application specific information of the parent business object is set to the IDoc type for Extension Module objects.
5.2.3 JR17956 20437 ODA Handle generation of business objects from a SAP 4.0 system for IDocs that are in a definition file and that are extension types.

5.2.3

JR17956

20269

Extension Module

Delete records from the CWLD/OBJ_ARC_H and /CWLD/OBJ_ARC_I tables in smaller batches using transaction /CWLD/DELETE_OBJ_ARC.

5.2.3 JR17956 18381 Bapi, Rfcserver Modules Remove formatting delimiters within date and time fields.
5.2.3 JR17956 16820 Rfcserver, ALE Modules When terminating this module, the parser thread is also terminated.
5.2.3 JR17956   ALL Update French messages files.

5.2.2

JR17879

18941

ALE Module

Improves the performance of the Ale Module.

5.2.1

 

18941

ALE Module

The TID is no longer being checked in the archive queue since checking the wip and event queue will maintain the same functionality. This enhancement will improve the performance of the Ale Module.

5.2.1

 

18440

Extension Module

Keep the value of ObjectEventId for an inbound transaction when returning the object back to the integration broker.

**** ATTENTION ****

Current ALE Module users ONLY: 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.  For further details, please refer to the adapter guide.

**** ATTENTION ****


UPGRADE INSTRUCTIONS

To perform an upgrade to this version of the connector:

  1. Upgrade to the most recent maintenance release (5.2.0) if you have not already done so.
  2. Apply the changes prescribed in each table below, beginning with the entries at the bottom of each table and working up to the most recent patch.

Add, replace, or remove the following files and directories as indicated:

For Connector Version

Platform [WIN;UNIX]

Add / Replace / Remove

File (Starting from %CROSSWORLDS% / $CROSSWORLDS)

5.2.5 WIN, UNIX Replace \connectors\messages\SAPConnector.txt - Only English Delivered
5.2.5 WIN, UNIX Replace \repository\SAP\CN_SAP.txt
5.2.5 WIN, UNIX Replace \connectors\SAP\dependencies\transports_4x\4_Request.zip

5.2.5

WIN, UNIX

Replace

\connectors\SAP\dependencies\transports_4x\ SAP4_Transports.txt

5.2.5 WIN, UNIX Replace \connectors\SAP\CWSAP.jar
5.2.4 WIN, UNIX Replace \connectors\SAP\start_SAP.sh
5.2.4 WIN, UNIX Replace \ODA\SAP\SAPODA.jar
5.2.4 WIN, UNIX Replace \connectors\SAP\CWSAP.jar
5.2.3 WIN, UNIX Replace \ODA\SAP\SAPODA.jar
5.2.3 WIN, UNIX Replace \ODA\messages\SAPODAAgent_fr_FR.txt
5.2.3 WIN, UNIX Replace \connectors\SAP\utilities\generatedfiles\utilreadme_fr_FR.txt
5.2.3 WIN, UNIX Replace \connectors\messages\SAPConnector_fr_FR.txt

5.2.3

WIN, UNIX

Replace

\connectors\SAP\dependencies\transports_4x\4_Tools_Maintenance.zip

5.2.3

WIN, UNIX

Replace

\connectors\SAP\dependencies\transports_4x\SAP4_Transports.txt

5.2.3

WIN, UNIX

Replace

\connectors\SAP\CWSAP.jar

5.2.2

WIN, UNIX

Replace

\connectors\SAP\CWSAP.jar

5.2.1

WIN, UNIX

Replace

\connectors\SAP\CWSAP.jar

Add or remove the following connector properties using CSM:

For Connector Version

Platform

Add / Remove

Property (Case-Sensitive)

5.2.5  WIN,UNIX Add ArchiveDays
5.2.4 - None      

5.2.3 - None

 

 

 

5.2.2 - None

 

 

 

 5.2.1 - None

 

 

 

UPGRADE NOTES:

To upgrade the Ale Module from version 4.8.1 and earlier to 5.2.5:

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.  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.2.5:

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:

To use the ALE Module to process large IDocs or IDoc Packets:

Refer to the MQSeries System Administration publication for more information on configuring the log files.


April 04, 2003 10:24 AM

© 2002 IBM Corp. Proprietary and Confidential. All Rights Reserved.