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:

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:

• Increase the Maximum Message Length of the MQSeries Queue Manager and its queues.  This length defaults to 4194304 bytes.
• Increase the log file size and the number of log files when you create the Queue Manager.
• 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.

February 24, 2004 10:17 AM

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