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.

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:

• Execution Stages

• Activation

• Generation

• Processing

• Completion

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

See Exporting Tables 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.