WebSphere Adapter for SAP Software

IDoc status updates

To monitor your IDoc processing, you can configure the adapter to update the IDoc status. When the adapter configuration property ALEUpdateStatus is set to true (indicating that an audit trail is required for all message types), the adapter updates the IDoc status of ALE business objects that are retrieved from the SAP system. After the event is sent to the message endpoint, the adapter updates the status of the IDoc in SAP to indicate whether the processing succeeded or failed.

The adapter updates a status IDoc called ALEAUD that the adapter sends to the SAP system as an inbound IDoc event.

The IDoc status codes are defined in the following table:

Table 1. IDoc status codes
IDoc status code value Description
12 The dispatch processed without errors.
11 An error occurred during dispatch.

An IDoc that is not successfully sent to the endpoint is considered a failure, and the IDoc status is updated by the adapter to 11. Similarly, an IDoc that reaches the endpoint is considered successfully processed, and the status of the IDoc is updated to 12.

These codes and their associated text are configurable properties of the adapter, as specified in the J2C activation specification properties. The properties and their values are listed in the following table:
Table 2. Configuration properties for IDoc status codes
Adapter property Value
ALESuccessCode 12
ALEFailureCode 11
ALESuccessText Dispatch OK
ALEFailureText Error during dispatch
For inbound processing, perform the following tasks to ensure that the adapter updates the standard SAP status code after it retrieves an IDoc:
  • Set the AleUpdateStatus configuration property to true and set values for the AleSuccessCode and AleFailureCode configuration properties.
  • Configure the inbound parameters of the partner profile of the logical system in SAP to receive the ALEAUD message type. Set the following properties to the specified values:
Table 3. Inbound properties of the logical system partner profile
SAP property Value
Basic Type ALEAUD01
Logical Message Type ALEAUD
Function module IDOC_INPUT_ALEAUD
Process Code AUD1

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)