Monitoring Workflows

Overview

Universal Controller allows you to monitor running Workflows in graphical format. As the Workflow progresses, the display provides up-to-date textual and color-coded status information for each task instance in the Workflow. You can also intervene in processing where necessary.

Monitoring a Running Workflow

Note

A Workflow already must be running in order for you to monitor its status.

Step 1

From the Automation Center navigation pane, select Task Instances > Activity.

Step 2

Click the Details icon for the Workflow you want to monitor. The Workflow Task Instance Details for that Workflow displays.

Step 3

Click the View Workflow button to display the Workflow Monitor for that Workflow, as shown in the following example.
 

Note

The name of the workflow that you are monitoring is shown:

  1. At the bottom right corner of the Workflow Monitor.
  2. By hovering over the Workflow Monitor tab at the top of the Workflow Monitor.

Workflow Monitor Modes

The Workflow Monitor has two modes. Each mode, which you select by clicking the appropriate icon in the Workflow Monitor toolbar, allows you to use one or more specific Workflow Monitor tools.
 

Icon

Mode

Description

Select

Clicking the Select icon on the Workflow Monitor toolbar places the Workflow Editor in Select mode, which allows you to use all Workflow Monitor tools except Connect and Pan. The Select mode is the default mode for the Workflow Monitor.

Pan

Clicking the Pan icon on the Workflow Monitor toolbar places the Workflow Monitor in Pan mode, which allows you to scroll around in the Workflow. (You also can use the Outline tool in any mode) to scroll around in the Workflow.
 
In Pan mode, you also can use all other Workflow Monitor tools.
 

Note

Pan mode does not allow you to use the drag and drop method for moving, deleting, and copying groups of Workflow elements.

Viewing Predecessors/Successors of Task Instances in a Workflow

You can view the predecessors/successors of all task instances in a workflow from the Activity Monitor, Task Instances list, and the Workflow task instance Details.

You can view the predecessors/successors of a single task instance in a workflow from the Activity Monitor, Task Instances list, and the Workflow Monitor.

(You can also view the predecessors/successors of all task instances in a workflow, or the predecessors/successors of a single task instance in a workflow.)

See Viewing Task Predecessors/Successors.


Viewing Blocking Ancestors of Task Instances in a Workflow

You can view the blocking ancestors of task instances in a Workflow task instance from:

  • Activity Monitor
  • Task Instances list
  • Workflow Monitor

Only task instances that have not started (that is: Defined, Waiting or Held status) will qualify. 

See Viewing Blocking Ancestors.

Workflow Monitor Toolbar

The Workflow Monitor toolbar, which displays above the Workflow Monitor, contains icons for every tool that you need to monitor a Workflow.

A shadowed outline around the icon in the toolbar indicates the currently selected Workflow Monitor mode.

The following example shows that the Workflow Monitor is in Select mode.


 

Workflow Monitor Tools

The following table describes the tools used to monitor Workflows, including the tools associated with the two Workflow Monitor modes. The tools are listed by icon, as they appear - left to right - in the Workflow Monitor toolbar.
 

Icon

Tool

Description

View Parent

If this Workflow is embedded in another Workflow, navigates to the parent. If this Workflow has more than one parent, clicking this icon displays a list of all parent Workflows; in this case, to navigate to a parent Workflow, double-click the Workflow's icon. To return to your original Workflow, click its name. (The current Workflow name displays in the lower right corner of the editor.)
 

Note

To open an embedded Workflow (sub-Workflow) from its Parent Workflow, double-click the embedded Workflow.

Print

Prints the current Workflow.

Select

Places the Workflow Monitor in Select mode.

Pan

Places the Workflow Monitor in Pan mode.
 
To pan around the Workflow, click anywhere in the Workflow Monitor canvas and drag your cursor to display any section of the Workflow.
 
To return to your original location, click the Actual Size icon.

Undo

Click to undo the most recent change.

Redo

Click to redo the most recent change that you undid by clicking Undo.

Fit

Fits the Workflow into the display. If necessary, this shrinks the icons and size of the Workflow in order to make it fit. You can undo a Fit by clicking the Actual Size icon.

Zoom In

Zooms in (enlarges) the Workflow. To return the Workflow to its default size, click the Actual Size icon.

Zoom Out

Zooms out (diminishes) the Workflow. To return the Workflow to its default size, click the Actual Size icon.

Actual Size

Returns the Workflow to its default size after a Fit or Zoom.

Zoom

Opens a window that allows you to specify a zoom ratio. For example, to double the size of the Workflow, enter 200 and click OK. To return the Workflow to its default size, click the Actual Size icon.

Horizontal Layout

Reformats the Workflow into a horizontal layout.

Vertical Layout

Reformats the Workflow into a vertical layout.

Toggle Vertex Style

For running Workflows, switches the icon display between status-related icons and task-related icons (see Workflow Monitor Display Mode). This icon only appears on the icon bar when you are monitoring a running Workflow.

Toggle Critical Path View

Toggles between the normal view of the Workflow and the Critical Path View.
 

Note

This icon displays in the toolbar only if the Critical Path Calculations Permitted Universal Controller system property is set to true.

Outline

For large Workflows, the outline provides a way of positioning a specific area of the Workflow in the display, without using the Pan mode.

  1. Click the Outline icon. The Outline window opens.
  2. In the Outline window, move and/or resize the blue box to identify the area of the Workflow you want to work on. The display repositions to show only the area within the blue box.

Help

Displays help documentation for Workflows.

Console

While a Workflow is running, you can click the Console icon to display processing messages.

Workflow Monitor Display Mode

The default display mode for the Workflow Monitor identifies each task instance in the workflow by:

Task Name

The task name is the name given to a task when it was created (see Creating Tasks).

Task Type

The task type of each task instance is represented by an icon that displays above the task instance name.
 

Agent File Monitor

Application Control

Email

Email Monitor

File Transfer

Linux/Unix

Manual

PeopleSoft

Recurring

Remote File Monitor

SAP

SQL

Stored Procedure

System Monitor

Task Monitor

Timer

Universal

Universal Command

Variable Monitor

Web Service

Windows

Workflow

z/OS


Note

You can change the Workflow Monitor so that the icon above each task instance name represents the current status of that task instance (see Displaying Task Status Icons).

Task Instance Status

The current status of each task instance displays below the task instance name.

The Controller assigns a default color for each status, which you can change. See Colors for a list all statuses and the default colors assigned to them, and for information on how to change any of the colors.

Task Instance Details

You can display the following detailed information (including status) for any task instance by hovering your mouse over the task instance.
 


 

Note

The Next Retry Time field displays in the menu only if the task instance is in Failed status and scheduled for retry.

The Task Description field displays in the menu only if the Workflow Monitor Task Description Enabled Universal Controller system property is set to true.

Task Instance Actions

For each task instance in a Workflow, the Controller provides a menu of actions that you can take on that task instance. You can perform task instance actions in either Workflow Monitor mode: Select or Pan.

To display the menu of task instance actions, right-click a task instance.
 

Action

Description

View/Edit

Allows you to view and edit the Task Instance Details for this task instance.

View/Edit In Tab

Allows you to view and edit the Task Instance Details for this task instance in a new tab.

View Children

For a workflow task instance only; Allows you to view a list of children task instances of this workflow task instance.

View Tree

For a workflow task instance only; Allows you to view a tree of this workflow task instance and its tasks, including children tasks of any sub-Workflow task, and, optionally, lets you display the Details for any of those tasks.

Commands

Allows you to run a command against the task instance.

View Predecessors/Successors

Allows you to view all predecessors and successors of this task instance in the Workflow.

Insert Task As Predecessor

Allows you to insert a task as a predecessor to this task instance.

Insert Task As Successor

Allows you to insert a task as a successor to this task instance.

Details > Show Details

Allows you to display complete database details for this task instance.

Details > Show Variables

Allows you to display a list of all variables available to this task instance.

Properties

Displays a menu of properties for the task instance.

Task Instance Actions for Workflow

For a workflow task instance being monitored, the Controller provides a menu of actions that you can take on that workflow task instance. You can perform these actions in any Workflow Monitor mode.

To display the menu of workflow task instance actions, right-click anywhere in the Workflow Monitor canvas.
 

Action

Description

View/Edit

Allows you to view and edit the Task Instance Details for this workflow task instance.

View/Edit In Tab

Allows you to view and edit the Task Instance Details for this workflow task instance in a new tab.

View Children

Allows you to view a list of children task instances of this workflow task instance.

View Tree

Allows you to view a tree of this workflow task instance and its tasks, including children tasks of any sub-Workflow task, and, optionally, lets you display the Details for any of those tasks.

Commands

Allows you to run a command against this workflow task instance.

Show Skipped/Restore

Allows you to show any skipped tasks for this workflow task instance.

Hide Skipped

Allows you to hide any skipped tasks for this workflow task instance.

Find In Workflow...

Allows you to find a task instance in this workflow task instance.

Pan To Top

Allows you to restore the displayed Workflow Monitor for this workflow task instance to its default, top-left position.

Insert Task...

Allows you to insert a task.

Details > Show Details

Allows you to display complete database details for this workflow task instance.

Details > Show Variables

Allows you to display a list of all variables available to this workflow task instance.

Task Instance Properties

One of the task actions available for any task instance in a Workflow is to display a list of properties for that task instance.
 


 

Connector Details

You can display the following detailed information for any Connector by hovering your mouse over the connector.
 

Connector Actions

For each connector in a Workflow, the Controller provides a menu of actions that you can take on that connector. You can perform connector actions in any Workflow Monitor mode.

To display the menu of connector actions, right-click a connector.
 

The following table describes each action in the menu:

Action

Description

Conditions

Allows you to select a dependency condition for the connecor.

Go To Source

Highlights the predecessor task for the connector and moves it to the center of the Workflow Editor display.

Go To Target

Highlights the successor task for the connector and moves it to the center of the Workflow Editor display.

Commands

Allows you to run a command (Mark as Satisfied) against the connector.

Properties

Displays a menu of properties for the connector.

Connector Properties

One of the connector actions available for any connector in a Workflow is to display a list of properties for that connector.
 


 

The information in the Connector properties is view-only.

Displaying Task Instance Status Icons

Each task instance status is categorized into one of five task instance status types: Running, Complete, Not Running, Problem, and Status Unknown.

Each task instance status type has a corresponding icon.
 

Running

Complete

Not Running

Problem

Status Unknown


You can switch the Workflow Monitor display mode, which by default shows icons that represent task instance types, so that the icons represent task instance status types, as shown in the following example.
 


 

To switch display modes, click the Toggle Vertex Style icon .

Manually Intervening in a Workflow

You can take action on a task instance in a running workflow by right-clicking the task instance and selecting an action from the Actions menu.

You also can take action on the running workflow itself by right-clicking any white space in the Workflow Monitor canvas and selecting an action from the Actions menu.

If you select a command from either Actions menu, the Console window automatically opens and displays processing information.
 

Monitoring the Critical Path in a Workflow

You can instruct the Controller to calculate the Critical Path of a Workflow, which is the path of task instances in the Workflow that will take the longest time to complete.

The Controller bases the Critical Path on:

  • Current historical average duration statistics for each task in the Workflow. (If no statistics exist for a task - that is, it has never been run - the Controller assigns it a run time of 1 second).
  • Critical Path Duration time that you can specify in the task Details for any task in the Workflow, which will override the run-time statistics.
     

Note

Critical Path settings for tasks and Workflows are not exported/imported.

Critical Path Settings

To monitor the Critical Path of a Workflow, you must set the following:

By default, any Workflow with the Calculate Critical Path field enabled will be displayed in the Workflow Monitor in Critical Path View. To toggle in and out of Critical Path View, click the Toggle Critical Path View icon.
 

Note

If you are using View In Workflow to open the Workflow Monitor, or the Workflow being opened has a status of Skipped, Critical Path View will be toggled off by default.

Running a Workflow Enabled for Critical Path

When you run a Workflow enabled for Critical Path, the Workflow Monitor initially displays the Critical Path based on historical average duration statistics and any CP Duration override values for any tasks in the Workflow. When a task instance completes, the Critical Path could change, based on the actual time it took the task instance to complete. For example, if you specified a Critical Path Duration of 5 minutes for a task, but the task instance completed in 30 seconds, the Controller might adjust the Critical Path to show a path that it now estimates will take the longest to complete.
 

Note

For a top-level Workflow that has been enabled for Critical Path, its sub-Workflows display Critical Paths only if they themselves have been enabled for Critical Path.


In Critical Path View, Task instances and connectors in the Critical Path display in the color specified by the Critical Path Color system property.
 


 

The Critical Path View is dynamic; if task instances are Skipped in a Workflow, and they longer are part of the Critical Path, they no longer display on the Workflow Monitor while it is in Critical Path View.

If you are in Critical Path View, but you want to see Skipped task instances, you can restore the standard view by clicking the Toggle Critical Path View icon in the Workflow Monitor toolbar.

Also, in Critical Path View, Show Skipped / Restore and Hide Skipped are disabled in the Workflow Monitor pop-up menu of commands and options.
 


 

When the Workflow completes, the final Critical Path displays.
 

Critical Path Status

Activity Monitor and Task Instances List

You can monitor whether a task instance is critical (or along a critical path) in a Workflow from the Activity Monitor and Task Instances List.

The task instance Details icon for task instances that are critical (or along in a Critical Path) is tinted red.
 

Reports

You can enhance existing Task Instance reports or create new Task Instance reports by utilizing the Critical and Projected End Time fields. For example, you might want to report on task instances that have not completed and are on the critical path, or you might want to report on task instances that have a failure status and are on the critical path.