Interacting with SAP Events

XBP 3.0 introduced new functionality known as Event History and which allows Redwood Server to interact with SAP Batch Events. Redwood Server events can now be mapped to SAP Batch Events. The state of Redwood Server events is constantly synchronized with an SAP Batch Events and parameter-combinations. Furthermore, Event History also keeps track of events, logging these for reference; this means that it is now possible to see if an event was raised in the past and when. You can define which events are used for event history in your criteria profile in SAP as well as define the events in Redwood Server. See the Criteria Manager section of the SAP Help for more information on defining event synchronization in SAP.

You define the events to be synchronized on the XBP Event Handling tab of the SAP system object. Once you defined your event matching, you synchronize the settings with the SAP instance using the Process Definition SAP_SynchronizeEventHistoryCriteria.

To enable Event History on a specific SAP instance, the instance must have XBP 3.0 or higher. Please consult your SAP documentation to find out if your instance qualifies.

The XBP Event Handling tab requires an RFC user with sufficient privileges as outlined in the Reference SAP RFC User Privileges.

Note: XBP 3.0 requires a logical system for the client, see the Setting Up Logical Systems section for more information on creating logical systems for clients.

Note: You can force the use of a specific XBP release, if it is available in the SAP system, by specifying the SynchronizationMode registry entry. This is especially handy on older NetWeaver 7.0 systems, which do not correctly report the available XBP version.

Note: You should use Redwood Server to maintain the criteria profile in SAP.

Prerequisites

  • The JCo libraries must be available, see the Installing the JCO Libraries topic for more information.
  • An SAP System with XBP 3.0 enabled
  • RFC User credentials with sufficient privileges

Procedure

Creating an event-handling rule

  1. Navigate to "Environment > SAP".
  2. Choose Edit from the context menu of the SAP System.
  3. Choose the XBP Event Handling tab and fill in the details.
  4. Click Save & Close.
  5. Navigate to "Environment > Process Servers".
  6. Choose Stop then Start from the context menu of the corresponding Process Server. Please wait for the Process Server to stop completely before starting it again.

Synchronizing event-handling rules with the SAP system

  1. Navigate to Definitions > Processes.
  2. Choose Submit from the context menu of SAP_SynchronizeEventHistoryCriteria.
  3. Fill in the parameters.
  4. Choose Submit.

Values

Information on the required settings for setting up event synchronization can be found in the Configuration Details on Interacting with SAP Events section of the documentation.

See Also