Execution Data
Every execution run performed in your system is recorded and stored in various forms, one of them being the lists of Executions. They provide detailed information about what happened during each execution of each task. They are a key audit feature that guarantees full audit capability. The Executions lists help you monitor and troubleshoot your processes.
This page includes the following:
Overview
The execution data lists are available for all executable objects, Agents, Clients, Queues and Servers. Each record in the list represents an execution run. By default, the most recent execution is displayed at the top of the list.
Recording the execution data is triggered as soon as an object is activated and ends when the execution is completed. All Executions lists display real-time data, that is, task or object changes are reflected immediately.
Right-clicking a record on the Executions list opens a context-menu that provides access to the functions available for the selected task.
Notes:
- The system keeps the execution data until explicitly removed from the database.
- You can customize the number of entries that should be displayed in the Executions lists. See Displayed Executions.
Types of Execution Lists
The following types of execution lists are provided:
-
Executions
Available for tasks that are processed individually
-
Child Task Executions
Tasks such as Workflows (JOBP), Groups (JOBG) or Schedules (JSCH) trigger the execution of other tasks (their children). The Child Task Executions is available for parents tasks and provides data on the execution of their children for a particular run.
Note: Automatic file transfers that store the external reports in the Automation Engine are child objects.
-
Parent Task Executions
Available for child tasks, these list provide data on the execution of both the parent and all its children.
-
Activator Executions
The activator is the instance that triggers the execution of a task. In the case of parent/child tasks, the activator of the child is usually the parent, but it must not always be so. If the child task is executed manually, for example, the activator is the user who triggered it.
Accessing the Execution Lists
To open the list of executions of a task, right-click it. If only one list is available, the corresponding option is displayed in the drop-down menu. If more lists are available, expand the Execution Lists option to display them and select the one that you need.
You can access the execution lists from the following areas in the Automic Web Interface:
- List of Tasks in the Process Monitoring perspective
- Job, Job Group, Workflow, Schedule, and Agent Group monitors, Fullfilments list
- Global search drop-down list
- List of results in the advanced search
Important! To be able to see these lists, your user definition must have the S - Executions authorization.
The following columns are displayed by default:
-
Name
Object name or alias, if available
-
Type
-
Platform
-
RunID
-
Parent
RunID of the parent task, if available
-
Status
-
Activation Time
Date and time of activation
-
Start Time
Date and time at which the task has started generating
-
End Time
Date and time at which the task ended
The following columns are also available:
-
Description
Text as defined in the assigned Period object
-
Users
User names of the task owners separated by a slash: Owner/Owner
The task owners either executes the task or actively assumes ownership of the task.
-
Runtime
Duration of the execution
- Agent
- Return Code
- Queue
- User ID
-
Internal Account
Freely definable text assigned to the source object upon definition
You can use this text to perform searches and filter objects and tasks.
-
Archive Key 1 and Archive Key 2
Freely definable keywords assigned to the source object. You can use them to perform searches and filter objects and tasks.
-
Version
Shows the object version.
-
Modification Flag
Shows if the task has been modified at runtime and the name of the user who made the last modifications.
-
Process ID
-
Remote Status
Available for SAP process chains and PeopleSoft Jobs, it indicates the status of the task in the target system
For more information, see Main Page Tables.
Note: By default, deactivated tasks are not displayed on the Tasks list. If you want to show them, you must activate the Include deactivated tasks check box at the bottom of the Filter pane in the Process Monitoring perspective.
Working with the Execution Lists
Right-click an entry in any of the execution lists to open a context-menu with the functions that are available to that execution. The functions that you can perform depend on the type of task to which the entry refers and on the status of the execution. For more information, see Available Functions Depending on the Task Status.
The Show in Process Monitoring option is always available. It opens the list of Tasks in the Process Monitoring perspective. The list is filtered using the runID of the selected execution.
Execution List for Executable Objects
All execution lists of executable objects display the same columns. Some are hidden by default. For more information, see Working with Tables.
The definition of the object that underlies a task includes an attribute that determines when that task should be deactivated automatically (see Automatic Deactivation Section). Deactivated tasks are not displayed on the list of Tasks in the Process Monitoring perspective. However, their Executions lists are accessible.
Status of Tasks in the Execution Lists
When a task is executing, it goes through four execution stages. During each stage multiple things happen. To mention but a few: PromptSets are read, Agent Groups and Variables are resolved, scripts are generated, a number of checks happen and actions are taken based on those checks, and so forth. This means that during its runtime, that is, as long as a task is Active, it goes through many statuses.
The execution lists do not display these intermediate statuses. If a task is still executing, the Status column displays Unknown, meaning that the task is in any of the possible intermediate statuses. If you open the Details pane for a task with an Unknown status, the Status field indicates Active. This lets you know that the task status is unknown because it is still executing.
For detailed information about what happens during each execution stage and the statuses of a task during each stage, see:
Filtering for Deactivated Tasks
When defining executable objects, in the Automatic Deactivation Section of the Attributes page you can specify when they should be deactivated. This functions enhances the information provided by the list of historical data in the Executions lists.
Deactivated tasks are not visible by default in the Tasks list in the Process Monitoring perspective. If you want to see them on the list, activate the Include deactivated tasks checkbox at the bottom of the Filter pane. This sets the Time Frame automatically to Default time span: 12 hours. This means that all tasks that have been deactivated within the past 12 hours will also be included in the Tasks list. As a system administrator, you can change the default value of 12 hours. For more information, see Including or Excluding Deactivated Tasks.
Note: Activating this option may impact your system performance.
Exporting to CSV
Execution List for Agents
Recording the data begins when the Agent starts and ends when it terminates. In addition, an entry is created with every log rotation. For more information, see Initiating Agent Log Rotation.
The Agent execution data is available in Client 0 only.
Execution List for Clients
Each row on the Client Executions list represents a session of the selected Client. Recording the data begins when the Client starts and ends when it terminates.
Execution List for Servers
Each row on the Server Executions list represents a connection to the server.
See also: