Show TOC

Function documentationUse of Event Handler Details Locate this document in the navigation structure

 

You can have the system display the detailed information about an event handler. To do so, from the event handler overview, call the event handler details and display the following detailed information:

  • The header data, all parameters (system, control, and info parameters), the tracking IDs, and the query IDs

  • The history of the expected events, the measurement data, the status details, and additional detailed information, for example, the change document data

    Example Example

    For example, you can use the history to establish if an expected event has been reported several times. You can use relevant key figures in SAP NetWeaver Business Intelligence to evaluate this information.

    End of the example.

Event handler details can change as a result of the following:

  • When SAP Event Management (SAP EM) updates an event handler from the application system

    For example, the arrival at the customer occurs at 13:00 instead of 12:00. Here SAP EM updates the following data, for example:

    • Tracking IDs, query IDs, and authorization data

    • Change documents belonging to the event handler

  • When you send an event message

    • SAP EM performs tasks using rules and activities.

    • SAP EM updates the information that is contained in the event message, for example, information about an external event code set, the sender name, and the location code ID.

    • SAP EM updates the status details, error messages, and measurement data, as required.

Prerequisites

To use the functions for changing event handlers and their data, for example, Lock and Unlock in the event handler details, you have maintained the authorization data and generated profiles for your user role. Here you have used the authorization object X_EM_EH_CH in the EM class.

Features

If you have the appropriate authorizations, you can change the following event handler data manually:

  • Set the event handler header data to status changeable/not changeable.

  • Activate or deactivate event handlers

  • Activate or deactivate the application log and specify the degree of detail for logging

  • Reprocess event messages for the selected event handler with its actual data

    If you choose Reprocess Event Messages, you manually trigger a reprocessing of event messages and SAP EM processes all event messages again. You can choose between the following processing methods:

    • If you choose Simulate, you can use a simulation mode with a graphical interface and the system simulates the reprocessing, for example, activities in the rule set.

      For example, if an error occurs, you can check the processing logic of an event handler, and trace the reason why the event messages have not triggered the corresponding reactions, in other words, activities in the rule set, in a step-by-step way.

    • If you choose Reprocessing, the system reprocesses the event messages in the background, in other words, the system actually processes the event messages again.

      For example, the system is supposed to send an e-mail on the basis of an event message and the action that resulted from it. At this time the mail server is not available. The system does not send the e-mail. You use   Reprocess Event Messages   Reprocess   to trigger processing manually and the system sends the e-mail again.

  • Add, change, or delete data

    The following table provides an overview of which data you can add, change, or delete:

    Data

    Add

    Change

    Delete

    Info parameters

    x

    x

    x

    Control parameters

    x

    x

    x

    System parameters

    -

    x

    x

    Query IDs

    x

    x

    x

    Tracking IDs

    x

    x

    x

    Additional tracking IDs

    x

    x

    x

    Event handler statuses

    -

    x

    -

If you want to improve performance, you can hide the historical data for expected events, measurement data, or status attributes. Set the relevant indicator, for example, Disable Status Attribute Historical Data, in Customizing for SAP EM under Event Handlers and   Event Handler Data   Event Handlers   Define Event Handler Types  .

Activities

  1. On the SAP Easy Access screen, choose   Event Management   Monitoring and Lists   Event Handler List  .

  2. Display the event handler list and select the event handler whose data you want to change.

    The system displays the event handler overview.

  3. If you want to change data in the event handler details, proceed as follows:

    1. Choose Event Handler Detail Overview.

      The system displays the event handler detail screen (event handler details).

    2. Choose the change mode on the respective tab page to manually change data, for example, system parameters.

      Note Note

      If you want to change the status of an event handler, choose the Change EH Status setting instead of the change mode on the Status Details tab page.

      End of the note.
  4. Save your changes.