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 and 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 of the task or object. 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.

Note: The system keeps the execution data until explicitly removed from the database.

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

For objects in the Process Assembly perspective, tasks in the Process Monitoring perspective and Agents, Clients, Queues and Servers in the Administration perspective, do the following:

Right-click the object or task.
Select Monitoring > Executions (or any other of the available lists).

For tasks in the Dashboards or My Catalog perspectives, do one of the following:

Click the task.
Right-click and select Executions (or any other of the available lists).

Important! To be able to see these lists, your user definition must have the S - Executions authorization.

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.

Execution List for Executable Objects

All execution lists of executable objects display the same columns. Some are hidden by default. See Working with Tables for details on how to customize them.

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.

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. Deactivated tasks are not visible 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. You can change the predefined time span.

This functions enhances the information provided by the list of historical data in the Executions lists.

Note: Activating this option may impact your system performance.

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. See Initiating Log Rotation in Working with Agents.

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.