Upgrading the connector

This section describes how to upgrade the connector:

Upgrading the connector for the ALE Module's management of TIDs

The ALE Module persistently stores IDoc objects and Transaction IDs (TIDs) for every transaction it receives from the SAP application. In releases of the connector prior to version 4.8.x, the connector used IBM WebSphere collaborations, business objects, and maps to store the data in the repository. Version 4.8.x of the connector replaces the previous way of TID management with the use of MQSeries queues.

Attention: To enable the ALE Module to process IDocs to and from the SAP application, you must upgrade the connector. However, it is imperative that you allow the current IDoc processing cycle to complete before upgrading the connector.

Before you upgrade the connector to enable the ALE Module to process IDocs, you must complete the processing of current files in the event and WIP directories. Also, check the archive directory for failed and unsubscribed events.

To complete the processing of current files in the event and WIP directories:

To complete processing of any failed and unsubscribed events:

Note:
If, when using transaction SM58, you find unsuccessfully processed IDocs in the SAP system, wait until the connector is upgraded to resubmit these IDocs. After you complete the upgrade of the connector, correct the errors and resubmit the IDocs for processing through the MQSeries queues using the new TID management.

Once these directories are clear, apply the upgrade and follow the configuration instructions in:

Upgrading to the java-based connector

The is delivered as a Java-based connector (connector version 4.0.0 and later). In previous releases, the connector was written in C++. The directory structure is \connectors\SAP.

The following procedure is for upgrading a C++ version of the connector to the Java version of the connector.

  1. Rename the current connector directory.

    For example, \connectors\SAP becomes connectors\SAP.old.

  2. Rename the connector message file.

    For example, \connectors\messages\SAPconnector.txt becomes \connectors\messages\SAPconnector.txt.old.

  3. Copy the new connector directory and files to the \connectors directory.
  4. Copy the new connector message file to the \connectors\messages directory.
    Windows

    Modify the connector shortcut to point to the start_SAP.bat file in the connector directory. For example, if you are using the connector that supports SAP R/3 version 4.x, modify the shortcut to point to the connector startup file \connectors\SAP\start_SAP.bat.

Copyright IBM Corp. 2003, 2004