Objective: A SAP eventAction that is triggered if particular conditions apply. It can be an Automation Engine object type or an entry in a Policy Orchestrator EventBase. should be reported to the AE system in order to facilitate a reaction to it.
Objects used: Console event, Notification
Script elements used: ACTIVATE_UC_OBJECT, GET_EVENT_INFO, PRINT
Object types include events of type "Console". These are available for some of the AE-supported platforms, such as z/OS or Windows, and monitor their Console outputs. You can integrate this functionPre-defined run book template in the Automation Engine. One single step only, e.g. Start Windows Service, Copy file,… in your AE system in order to react to events that were not started by AE. This is illustrated in the SAP event shown below. An operator should be informed when a transport is made to a productive SAP system.
Events
First, a Console event is required which monitors the triggered SAP events. We want to react if a transport is made. The SAP system triggers the event "SAP_IMPORT_START" in such a case. Every time the agentA program that enables the de-centralized execution of processes (such as deployments) on target systems (computers or business solutions) or a service that provides connectivity to a target system (such as for databases or middleware). An agent is also an object type in the Automation Engine. [Formerly called "Executor."] See also: host informs the Console event, the content of !Process is executed. This means that a reaction to the triggered SAP event is possible with statements stored in !Process.
Create a Console event. The Console tab includes the main specification for this objectAutomation Engine controlled activities and processes are structured in the form of objects. See also: Task. Select the agent which is connected to the SAP system. Specify the selection criteria for the SAP events to be monitored in the lower table area. You can specify particular events or define filters using the wildcard charactersThese are placeholders for characters when you specify filters. ? stands for exactly one character, * for any number of characters. "*" and "?"; you can even use several lines. In this example, we use one line. Enter the Event IDFirst RunID of FileSystem and Console Events in the Automation Engine. Both Event types require communication between the AE component and an Agent. They communicate via the first RunID. Otherwise, Event identification is no longer possible after the first log change. "SAP_IMPORT_START" and complete the fields "Event Parameter" and "Event Server" according to your SAP system.
The following illustration shows the complete Console tab:
Notification
There are numerous ways of reacting to a triggered SAP event. For example, you can start subsequent processing using a workflowAn object of the Automation Engine that can include several executable objects and which runs them in a specified order. [Formerly called "ProcessFlow" and "JobPlan."]. In this example, we inform a userIn the Automation Engine, a user is an instance of a User object, and generally the user is a specific person who works with Automic products. The User object is assigned a user ID and then a set of access rights to various parts of the Automation Engine system and product suite. These access rights come in the form of Automation Engine authorizations and privileges, Decision user roles and EventBase rights and ARA web application object rights. You can manage all these centrally in the ECC user management functions. See also, Unified user management. with a notificationAn Automation Engine object type used to send messages to users and user groups. [Formerly called "CallOperator."].
Create a Notification object. Select the user to be informed and write a suitable message text. Specify the notification's priority and type.
Event
In the Console event, click the !Process tab. We want to store detailed information about the SAP event in the reportA report provides more detailed information about a task's execution or a component. and activate the notification. Information can be stored using the scriptA particular Automation Engine object type. function GET_EVENT_INFO. Depending on the assigned parameter, it supplies particular information about the SAP event. Several keywords are available which are listed in the document describing this script function. The agent informs about the SAP events in the interval which the administrator defined with the setting JOB_CHECKINTERVAL. We want to know the time when the SAP event was triggered and we retrieve the complete event parameter and server because we have specified both filters in the Console event. Then activate the notification "CALL.SAP_IMPORT_START".
:SET ×tamp# = GET_EVENT_INFO(TIMESTAMP)
:PRINT "timestamp: ×tamp#"
:SET ¶meter# = GET_EVENT_INFO(EVENT_PARM)
:PRINT "Event_parameter: ¶meter#"
:SET &server# = GET_EVENT_INFO(EVENT_SERVER)
:PRINT "Event_server: &server#"
:SET &ret# = ACTIVATE_UC_OBJECT(CALL.SAP_IMPORT_START)
Information about the SAP event can also be passed to the notification. More detailed information is provided in the sample: "Notification with Variable Message Text".
The report of the process execution is structured as follows:
Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support |
Copyright © 2016 Automic Software GmbH |