This Universal Task queries the SAP Event history table for a selected SAP Event & Parameter. If the Event is found, it gets confirmed, so that it is not triggered again. Optionally, a task can be launched based on the occurrence of an Event & Parameter.
Software Requirements for Universal Agent
Universal Agent for Linux or Windows Version 220.127.116.11 or later is required.
Universal Agent needs to be installed with python option (--python yes).
Software Requirements for Universal Controller
Universal Controller 18.104.22.168 or later is required.
Software Requirements for the Application to be Scheduled
SAP Credentials (Username and Password) to connect via the XBP-RFC Interface to SAP ERP System is required.
Some details about Universal Tasks to monitor the SAP Event History:
Query the SAP Event history table for a selected SAP Event & Parameter.
For the Parameters, wildcards “*” are supported.
Confirm Events in the SAP History Table ( SM62). When the Event and Parameter have been identified, the Event is confirmed in SAP so that the monitor will not trigger a second time (optional setting).
Launch a task in Universal Controller based on the occurrence of an Event & Parameter.
The Universal Task is supported on Linux and Windows Agents.
An automatic re-start of the task can be achieved by adding an action to the Universal Task, which restarts the task in the case of status success.
This Universal Task supports SAP Application Server and SAPNWRFC.INI Destination connections.
You can set different log-levels for the Universal task, which provides you more information in case of issues.
Import the SAP Event History Monitor Universal Template
To use theSAP Event History Monitor Template, you first must perform the following steps:
If no task is specified, the UT runs in monitoring mode and goes to success in case an Event has been identified; for example, you can add the Event Monitor to a Workflow.(Note: In that case, remove the action, which automatically re-starts the UT in if status is “success”)
[ Confirm , New ]
Default is “Confirm”.
Confirm: This ensures that the same event only triggers the event monitor once.
New: Leaves the event in status “New”, mainly for testing purpose.
Log level of the Universal Connector for SAP
trace | audit | info | warn | error
rfc_logon_retry_interval in s
interval in seconds between an new logon attempt to SAP.
Per default, 10 retries will be performed; for example, 120s means every 120s a new logon attempt to SAP is performed. If after 10 retries no logon to SAP was possible the Task fails.
Universal Task logging settings
[DEBUG | INFO| WARNING | ERROR | CRITICAL]
Example for SAP Event History Monitor Task
The following example monitors the SAP Event: UAC_TEST with Parameter: UAC in the SAP Event History.
If the Event occurs in the SAP Event history table with status “NEW”, the Task “Collect_Orders” is launched and the Event is confirmed in SAP.
In the following example, the Parameter “Multilaunch” is enabled. This means that if several events are found with the status “New”, the task “Collect_Orders” will be launched for each confirmed event.
Event Configuration in SAP
The SAP History Event Task Monitor scans for Events in the SAP Event history.
An Event only shows up in the Event history if an appropriate event criteria profile has been set-up in SAP by using transaction SM62.
Optionally, a criteria profile can also be set-up via an SAP Task of command group “Set CM Profile” in Universal Controller.
The following screen shows an example of the set-up in SAP using SM62.
Event History Table
The following provides and example of the Event history table in SAP (SM62).
Only Events showing up here can trigger the SAP Event History Monitor UT.
Task Monitor Trigger mode
You can create a Task Monitor trigger from this task by adding an action to the Universal Task, which restarts the task in the case of status success.