The patch note contains the following sections:
This patch contains the following revisions since the last maintenance release:
|
Available as of
Version |
APAR Number |
Clarify CR Number |
ClearQuest ID |
Feature |
Description |
| 5.4.1 | JR18707 | n/a | 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 | n/a | 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 | 24835/24898 | 24827/24890 | RFC Server, Bapi Modules | Bapi and Rfc events will now process successfully using this fixpack. |
|
5.4.1 |
JR18757 |
24706 |
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 |
23491 |
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 |
24151 |
24143 |
ALE Module |
A leading space is removed from the values of the data for the outbound control record object. |
|
5.4.1 |
JR18707 |
23869 |
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. |
To perform an upgrade to this version of the connector:
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.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 |
|
|
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.
August 14, 2003 11:03 AM
© 2002 IBM Corp. Proprietary and Confidential. All Rights Reserved.