WebSphere Adapter for SAP Software

Event processing for a single, parsed IDoc

An IDoc corresponds to a single business object. The adapter can process an ALE event that contains just one IDoc.

The adapter processes an inbound event for a single IDoc according to the following procedure:

  1. When the SAP system sends a transaction ID to the adapter, the adapter checks the status of the event and takes the following actions:
    • If this is a new event, the adapter stores an EVNTID (which corresponds to the transaction ID) along with a status of 0 (Created) in the event recovery table.
    • If the event status is -1 (Rollback), the adapter updates the status to 0 (Created).
    • If the event status is 1 (Executed), the adapter returns an indication of success to the SAP system.
  2. The SAP system sends the single IDoc to the adapter, which parses and converts the IDoc to a business object and stores it in memory.
  3. The SAP system sends a COMMIT call to the adapter.
  4. The adapter sends the business object to the appropriate message endpoint. The adapter can deliver objects to endpoints that support transactions as well as to endpoints that do not support transactions.
    • For endpoints that support transactions, the adapter delivers the business object as part of a unique XA transaction (a two-phase commit transaction) controlled by the application server. When the endpoint receives the event and the transaction is committed, the status of the event is updated to 1 (Executed). The message endpoint must be configured to support XA transactions.
    • For endpoints that do not support transactions, the adapter delivers the business object to the endpoint and updates the status of the event to 1 (Executed). The adapter delivers the business object without the quality of service (QOS) that guarantees once only delivery.
  5. If an exception occurs while the adapter is processing the event or if the endpoint raises an exception, the event status is updated to -1 (Rollback).
  6. If no exception occurs, the SAP system performs the following tasks:
    • It sends a COMMIT call to the adapter, and the event status is updated to 1 (Executed).
    • It sends a CONFIRM call to the adapter.

    The adapter then deletes the records with a status of 1 (Executed) and logs a common event infrastructure (CEI) event that can be used for tracking and auditing purposes.


Terms of use |

Last updated: Mon 30 Oct 2006 03:34:55

(c) Copyright IBM Corporation 2005, 2006.
This information center is powered by Eclipse technology (http://www.eclipse.org)