Knowledge Base > Automation Engine and Target Systems > SAP > Monitoring SAP Events

Monitoring SAP Events

Events are significant in SAP's background processing. Event objects of type "Console" can be used to monitor SAP events.

The agent periodically polls the SAP system for occurred SAP events and reports them to the active Console events in an interval the administrator has defined in the variable UC_HOSTCHAR_DEFAULT, key JOB_CHECKINTERVAL.

Filters are available which serve to define the SAP events to be monitored. The statements defined in the !Process tab initiate further processing steps as they are processed when an agent reports a SAP event.

Use the function GET_EVENT_INFO in the !Process tab. It supplies details about the SAP event that has occurred.

Several filter lines can be specified in the table in the tab's lower area. !Process is processed if a SAP event is triggered which meets at least one filter specification. !Process is NOT processed several times if several filter specifications are met.

Overlapping filters can occur if several Console events are used. The agent would then notify all Console events about the relevant SAP event.

AE does not only provide Console events but also functions which can be used to handle SAP events via Job objects. R3_GET_EVENT waits for a SAP-triggered event and R3_RAISE_EVENT can be used to trigger a SAP-defined event.

Procedure

Create an Event object of type "Console".
Open it and switch to the Console tab. Specify the agent that is connected to the SAP system and the filter criteria for the SAP events.
In the !Process tab, enter the script statement to be processed if a SAP event occurs which meets the specified filter criteria. The script function GET_EVENT_INFO supplies details about the SAP event.
If required, fill in the other tabs of the Console event and store the object.
Now activate the Console event in order to include SAP events in your processing.

Notes

XBP 3.0 is required in order to monitor SAP events of event type "Console". The administrator can specify the XBP 3.0 interface in the SAP agent's INI file.

If the agent loses its connection to the SAP system, SAP events can accumulate as the agent is not able to forward them to the Console events. As soon as the connection has been re-established, the agent checks if there are SAP events and reports them to the affected Console events.

Due to the fact that huge data amounts can be involved, the agent does not read all SAP events at once. The administrator can define the required handling in the agent's INI-file parameter maxEventTimeSpan= .

The agent cannot monitor SAP events if it is terminated. After a restart, it retrieves the point in time when it last monitored SAP events and also reports SAP events that occurred during its termination.

All agents connected to the SAP system poll SAP events. This means that each agent reports all SAP events which occurred to the Console events.

If the SAP system's time runs behind AE's system time, the first SAP events cannot be received if they occur in the gap between the two different times.