FixPack Notes for
Version 5.3.x of the IBM WebSphere Business Integration Adapter for mySAP.com

(for IBM CrossWorlds Infrastructure versions 3.0.1 through 4.2.x and WBIA versions 2.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.3.3 18707 24835/24898 RFC Server, Bapi Modules Bapi and Rfc events will now process successfully using this fixpack.

5.3.3

18757

24706

ALE Module

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

5.3.3

18757

23491

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.3.2

18707

24151

ALE Module

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

5.3.2

18707

23869

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. A new mandatory property, SAPALE_UnSubscribed_Queue, defines a queue to collect unsubscribed IDoc objects.  Unsubscribed IDoc objects previously were placed in the Archive queue.  Each unsubscribed IDoc object is saved as an individual message in this queue. These messages can be resubmitted using a new event management utility provided with this patch.  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.

3. 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.

5.3.2

18707

23653

RFC Server, Bapi Modules

The DATE and TIME formats can be changed.  A new property, DateTimeFormat, preserves the delimiters provided with DATE and TIME field values. If set to "Legacy", the connector will preserve the delimiters for DATE and TIME fields. Otherwise, the delimiters will be removed and the value's length will conform to the attribute defined length.

5.3.1

JR18522

22926

ALL

A  Java.lang.IllegalMonitorStateException is not being thrown when processing concurrent flows.

5.3.1

JR18522

22606

ALE Module

Events are now being processed successfully using WebSphere MQ 5.3.x.  If using MQ 5.2.x with ICS 4.1.1, you will need to install the latest MA88 classes for JMS from the IBM support site. With these classes, Ale events will be processed successfully.

5.3.1

JR18522

20700

RFC Server Module

The JCO client is needed to set attributes to an object.  When starting the Rfcserver module, it is now required to logon to the SAP system using connector properties, ApplicationPassword, ApplicationUserName, Client, Group, RefreshLogonCycle, Sysnr and SAPSystemID.

5.3.1

JR18205

22476

RFC Server Module

MQ sessions are no longer created if only the Rfcserver module is started.

5.3.1

JR18205

22469

Bapi, RFC Server Modules

The attribute value for the DATE and TIME fields are being set correctly.

5.3.1

JR18205

22406

ALL

Improvements have been made when the connector runs in multi-threaded mode.

5.3.1

JR18205

22390

ALE  Module

Request processing performance has been improved with this patch.  Please review the upgrade instructions below.

5.3.1

 

22130

Extension Module

For object keys using name value pairs, account for keys that have no values.

5.3.1

JR18205

22073

ALE Module

Changes have been made for service call requests for new versions of JCO.  When running on AIX platforms this patch will fix the core dumps.

5.3.1

JR18205

20328

Extension Module

Hierarchy levels greater than 8 are now supported.

5.3.1

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.3.1

JR18066

22220

ODA

The ODA has been enhanced to handle the special characters in the IDoc.

5.3.1

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.

UPGRADE INSTRUCTIONS

To perform an upgrade to this version of the connector:

  1. Upgrade to the most recent maintenance release (5.3.0) if you have not already done so.
  2. Upgrade to the latest version of WBIA runtime at http://www-1.ibm.com/support/docview.wss?uid=swg24004498.  Refer to the description section in the WBIA fix pack for additional changes.  The CWConnEnv or CWODAEnv scripts may require changes.
  3. Obtain jCO version 2.0.8 from http://service.sap.com/connectors.
  4. Upgrade to the latest version of MA88 at http://www-3.ibm.com/software/integration/support/supportpacs/individual/ma88.html if you are using WebSphere MQ Series version 5.2.x.  This by default will install to C:\Program Files\IBM\MQSeries.  For ICS, a new directory may need to be created under the %CrossWorlds% home directory called MA88.  Copy the Java lib directory from the MA88 fix pack to the MA88 directory under the %CrossWorlds% home directory.
  5. 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.  If a file has been changed for multiple version releases, it will only appear once in the 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.3.3

WIN, UNIX

Replace

\connectors\SAP\CWSAP.jar

5.3.3

WIN, UNIX

Replace

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

5.3.3

WIN, UNIX

Replace

\ODA\SAP\SAPODA.jar

5.3.3

WIN

Add

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

5.3.3

WIN

Add

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

5.3.3

WIN

Add

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

5.3.2

WIN, UNIX

Replace

\connectors\SAP\CWSAP.jar

5.3.2

WIN, UNIX

Replace

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

5.3.2

WIN, UNIX

Replace

\repository\SAP\CN_SAP.txt

5.3.2

WIN

Add

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

5.3.2

WIN

Add

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

5.3.2

WIN

Add

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

5.3.1

WIN, UNIX

Replace

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

5.3.1

WIN, UNIX

Replace

\repository\SAP\CN_SAP.txt

5.3.1

WIN, UNIX

Replace

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

5.3.1

WIN, UNIX

Replace

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

5.3.1

WIN, UNIX

Replace

\connectors\SAP\CWSAP.jar

5.3.1

UNIX

Replace

\connectors\SAP\start_SAP.sh

5.3.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.3.2

WIN,UNIX

Add

DateTimeFormat

5.3.2

WIN,UNIX

Add

SAPALE_UnSubscribed_Queue

5.3.2

WIN,UNIX

Add

SAPALE_Error_Queue

5.3.1

WIN,UNIX

Add

ArchiveDays

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:

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:

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.

August 04, 2003 03:08 PM

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