Events are significant in SAP's background processing. Event objects of type "Console" can be used to monitor SAP events, see Monitoring Monitors.
Note: 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 SAP forms initiate further processing steps as they are processed when an agent reports an SAP event. For more information on the Form view of SAP Jobs, see Forms View on the Process Page.
Note: Use the GET_EVENT_INFO script function in the Event Process page. This function supplies details about the SAP event that has occurred. For more information, see GET_CONSOLE, GET_EVENT_INFO.
Several filter lines can be specified in the table in the tab's lower area. The Event Process page is processed if an SAP event is triggered which meets at least one filter specification. The Event Process page 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.
Note: The AE also provides script functions which let you handle SAP events via Job objects:
- R3_GET_EVENT
Waits for an event triggered by SAP - R3_RAISE_EVENT
Triggers an SAP-defined event
Procedure
- Create an Event object of type "Console".
- Open it and switch to the Console Event page. Specify the agent that is connected to the SAP system and the filter criteria for the SAP events.
- In the Event Process page, enter the script statement to be processed if an SAP event occurs which meets the specified filter criteria.
Tip: Use the GET_EVENT_INFO script function to supply details about the SAP event. For more information, see GET_CONSOLE, GET_EVENT_INFO. - 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 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 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.
Important! 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.
See also: