Fix Pack Notes for
Version 5.4.x of the IBM WebSphere Business Integration Adapter for mySAP.com

(for IBM CrossWorlds Infrastructure versions 4.1.0 through 4.2.1 and WBIA versions 2.0.0 through 2.3.1)


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.4.4 JR19262 31605 ODA The following error message, "SAP client error originating from code generator.  Unable to get a client for the SAP system.  Number of connections in pool CWOdaConnPool exceeds limit of 1." occurred due to not retrieving the display length correctly for certain attributes of "BCD" data types.  This has been resolved with this fix pack. 
5.4.4 JR19262 30429 ALE Module With this fix pack, all malformed IDOCs will be sent to the SAPALE_Error_Queue.
5.4.4 JR19262 30433 ALE Module The ALE Module will work with SAP 3.x systems with this fix pack.
5.4.4 JR19262 30200 HDR Module Objects containing foreign keys will process successfully with this fix pack.
5.4.4 JR19262 25957 ALL Configuration properties are now case-insensitive and a descriptive message is logged if any of the mandatory MQ Queues are missing or misspelled.
5.4.3 JR19194 28984 Extension Module A new button called Maintain Objects was added to the CW Station within SAP.  When executed, it will display objects to maintain.
5.4.3 JR19194 28565 ALE, BAPI, RFC Server Modules The CN_SAP.txt file has been updated to contain the new properties, SAPALE_UnSubscribed_Queue, SAPALE_Error_Queue, DateTimeFormat.
5.4.3 JR19194 27726 ALE Module The Eventstate.log file now gets created in the directory specified in the connector configuration property - AleEventDir. 
5.4.3 JR19194 26043 BAPI Module This fix pack ensures that the return status descriptor is populated with detailed information. Also all the error information is logged in the connector log and trace files.
5.4.3 JR19194 25820 ODA Some business object's return structure that are available in SAP R/3 47 were different than the standard that caused compilation error.  The generated files will compile correctly with this fix pack.  
5.4.3 JR19194 25810 ODA The Business Object Repository contained duplicates names and were being overwritten.  With this fix pack, all items in the BOR tree will be displayed correctly.
5.4.3 JR19194 23916 ODA Now the field names will be used as the attribute name when a function uses add-on tables with no descriptions.

5.4.2

JR18948

25512

Extension Module

Extension module can handle DBCS data properly.

5.4.1

JR18707

25385

ALE Module

This utility is an enhancement that may be used to resubmit event messages, dump event messages to a file system for viewing and archive messages to a file system.  The connector now checks for subscriptions when processing the data from SAP to the connector.  This results in transactions remaining in SAP until the collaboration is started.

5.4.1

JR18707

25384

ALE Module

This is an enhancement to send ALE error events to a new queue named, SAPALE_Error_Queue and also unsubscribed events will be send to a new queue named, SAPALE_UnSubscribed_Queue.

5.4.1

JR18707

24827/24890

RFC Server, Bapi Modules

Bapi and Rfc events will now process successfully using this fixpack.

5.4.1

JR18757

24698

ALE Module

With this patch the performance will not degrade when the SAPALE_Event_Queue grows.  It will remain consistent.

5.4.1

JR18757

23485

ODA

We are now able to determine the display length of "BCD" data types. The display length in the table will now be the same as the maximum length field for that attribute.

5.4.1

JR18707

24143

ALE Module

A leading space is removed from the values of the data for the outbound control record object.

5.4.1

JR18707

23863

ALE Module

1. Memory consumption is minimized by using the Poll Quantity to limit the number of messages that are pre-processed from the Event queue.

2. The message body of an MQ message does not get passed correctly from the WIP queue to the Event queue depending on the version of MA88 if you are using WebSphere MQ Series version 5.2.x..  A new mandatory property, SAPALE_Error_Queue, defines a queue to handle these MQ messages. To avoid this scenario, please use the latest version of MA88 with this fix pack.


UPGRADE INSTRUCTIONS

To perform an upgrade to this version of the connector:

  1. Upgrade to the most recent maintenance release (5.4.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.4.4

WIN, UNIX

Replace

\ODA\SAP\SAPODA.jar
5.4.4 WIN,UNIX Replace \connectors\SAP\CWSAP.jar
5.4.4 WIN,UNIX Replace \connectors\messages\SAPConnector.txt - Only English Delivered
5.4.3

WIN, UNIX

Replace

\connectors\SAP\dependencies\transports_4x\4_Tools_Development.zip
5.4.3

WIN, UNIX

Replace

\connectors\SAP\dependencies\transports_4x\4_Utilities.zip
5.4.3

WIN, UNIX

Replace

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

WIN, UNIX

Replace

\repository\SAP\CN_SAP.txt

5.4.3

WIN, UNIX

Replace

\ODA\SAP\SAPODA.jar
5.4.3 WIN, UNIX Replace \connectors\SAP\CWSAP.jar
5.4.2 WIN, UNIX Replace \connectors\SAP\CWSAP.jar

5.4.1

WIN, UNIX

Replace

\connectors\messages\SAPConnector.txt - Only English Delivered

5.4.1

WIN, UNIX

Replace

\repository\SAP\CN_SAP.txt

5.4.1

WIN

Add

\connectors\SAP\utilities\AleEventUtil\BIA_AleEventUtil.jar 

5.4.1

WIN 

Add

\connectors\SAP\utilities\AleEventUtil\BIA_AleEventUtil.bat 

5.4.1

WIN 

Add

\connectors\SAP\utilities\AleEventUtil\BIA_AleEventUtil_readme.txt 

5.4.1

WIN, UNIX

Replace

\connectors\SAP\CWSAP.jar

5.4.1

WIN, UNIX

Replace

\ODA\SAP\SAPODA.jar

Add or remove the following connector properties using CSM:

For Connector Version

Platform

Add / Remove

Property (Case-Sensitive)

5.4.1

WIN,UNIX

Add

SAPALE_UnSubscribed_Queue 

5.4.1

WIN,UNIX 

Add

SAPALE_Error_Queue 

UPGRADE NOTES:

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:

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.


November 21, 2003 02:54 PM

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