Logging with Change Documents 

Use

SAP Event Management (SAP EM) logs the changes made to data related to event handlers in change documents. In this way, you can trace the changes made and can always check what was changed as well as when and how it was changed. This makes it easier for you to analyze errors.

Prerequisites

You have activated logging with change documents in Customizing for SAP Event Management under Event Handlers and Event Handler Data ® Event Handlers ® Define Event Handler Types.

Features

Creation of a Change Document

When the following data related to event handlers is changed, SAP EM writes a change document:

·        Event handler header data

·        Expected events

·        Info parameters

·        Control parameters

·        Query IDs

·        Tracking IDs

SAP EM can also create change documents for multiple event handlers at the same time. SAP EM creates change documents for data changes that you make directly using transaction /SAPTRX/EH_LIST or that you send to SAP EM with an event message. SAP EM also automatically creates a change document for each dependent change made to expected events, in other words, for all changes dependent on your manual changes. SAP EM saves these changes under the same user name.

Displaying a Change Document

You can display the change documents in the event handler detail overview on the Change Documents tab page.

Deletion of a Change Document

When you delete an event handler and the corresponding data in SAP EM, SAP EM does not create a change document, but instead it deletes the relevant existing change documents. Even if you only delete the event handler header data, SAP EM also automatically deletes all the relevant event handler data and change documents.

If, however, you delete an event handler and the corresponding data in SAP EM and then create a new event handler with the same event handler GUID, the relevant existing change documents are retained.

Archiving a Change Document

When SAP EM archives event handler data, it also archives the relevant change documents at the same time. For archiving change documents, SAP EM uses the archiving object /SAPTRX/A0 to archive event handler data and the archiving object /SAPTRX/A2 to archive event handler set data.

For more information about the concept behind logging with change documents and about the structure of change documents, see the SAP Library under SAP NetWeaver ® Application Platform (SAP Web Application Server) ® ABAP Technology ® ABAP Workbench (BC-DWB) ® BC Extended Applications Function Library ® Change Documents.

See also:

Archiving and Deletion in SAP Event Management