Monitoring Workflows
- 1 Overview
- 2 Monitoring a Running Workflow
- 3 Viewing Predecessors/Successors of Task Instances in a Workflow
- 4 Viewing Blocking Ancestors of Task Instances in a Workflow
- 5 Viewing a Timeline for a Workflow Task Instance
- 6 Workflow Monitor Toolbar
- 7 Workflow Monitor Display Mode
- 8 Manually Intervening in a Workflow
- 9 Monitoring the Critical Path in a Workflow
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:
At the bottom right corner of the Workflow Monitor.
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. |
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.
Viewing a Timeline for a Workflow Task Instance
You can display the progress of a Workflow task instance in a timeline format from:
Activity Monitor
Task Instances list
Workflow Task Instance Details
Workflow Monitor
See Viewing a Timeline for a Workflow Task Instance.
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. |
| Prints the current Workflow. | |
| Select | Places the Workflow Monitor in Select mode. |
| Pan | Places the Workflow Monitor in Pan mode. |
| 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.
|
| 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 Monitor | |
File Transfer | IBM i | Linux/Unix | Manual |
PeopleSoft | Recurring | Remote File Monitor | SAP |
SQL | Stored Procedure | System Monitor | Task Monitor |
Timer | Universal | Universal Command | Universal Monitor |
Variable Monitor | Web Service | Windows | Workflow |
z/OS | z/OS Monitor |
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.
In the Activity or Task Instance List, you can add the Simulate field to determine if an instance is running under simulation mode. However, in the Workflow Monitor, the Status is followed by an asterisk if the instance is executed under simulation mode. For example, the instances in this workflow were executed under simulation mode:
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.
The Exit Code is displayed in parenthesis only if the instance is in end state (Success, Failed, Finished).
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.