Versions Compared

Old Version 13

changes.mady.by.user Stonebranch

Saved on

compared with

New Version Current

changes.mady.by.user Stonebranch

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Panel
Table of Contents

Overview

The Task Monitor task monitors another task or tasks for one or more specific statuses.

When setting up a Task Monitor task, you can monitor:

  • All tasks
  • Specific task
  • Task type, such as a Windows task
  • Group of tasks based on the name, such as all tasks whose name contains the string DEV

You also can monitor for any combination of task statuses.

For example, you can monitor for:

  • All tasks with a status of RESOURCE WAIT or UNDELIVERABLE
  • All Windows tasks in a FAILED status
  • All tasks whose name contains REPORT that have a status of SUCCESS.

For Task Monitors within a workflow, you can also specify a Time Scope, or window of time, during which the event being monitored for must be satisfied.

Built-In Variables

The following built-in variables can be used in a Task Monitor task to pass data where appropriate:

Processing Flow for Task Monitors

The processing on a Task Monitor may differ depending on which of the following methods was used to launch it:

  • Launched by a workflow
  • Launched by a Task Monitor trigger
  • Launched manually or by another trigger

Each method is described in detail below.
 

Note
titleNote

Any changes made to a Task Monitor task are not recognized by its respective Triggers until those Triggers are disabled and re-enabled.

Anchor
Launching a Task Monitor Task Within a Workflow
Launching a Task Monitor Task Within a Workflow
Launching a Task Monitor Task Within a Workflow

Within a Workflow, the Task Monitor task launches like any other task in the Workflow; that is, whenever the Workflow conditions warrant it. The Task Monitor runs until one of the conditions described below occurs:

  • When the conditions specified in the Task Monitor are met, the Task Monitor goes to a status of SUCCESS.
  • When the time window specified in the Task Monitor passes and the conditions in the Task Monitor are not met, the Task Monitor goes to a status of FAILED. If the time window is entirely in the past and Universal Controller does not locate the required event in the Activity table when the Task Monitor launches, the Task Monitor goes immediately to a FAILED status.
  • If no time window is specified in the Task Monitor and the Task Monitor conditions are not met, the Task Monitor task continues running.
  • A user can manually force finish the Task Monitor task.

The following diagram illustrates how a Task Monitor might go to SUCCESS and FAILED status within a workflow.

Anchor
How a Task Monitor Works When Launched by a Trigger
How a Task Monitor Works When Launched by a Trigger
Launching a Task Monitor Task Using a Task Monitor Trigger

The Task Monitor task launches when the user enables the Task Monitor trigger. Each time the conditions in the Task Monitor task are satisfied, the tasks specified in the trigger are launched. This process continues until a user disables the associated Task Monitor trigger.

The following diagram shows an example of how you might set up a task monitoring scheme using the Task Monitor task and Task Monitor trigger.

Launching a Task Monitor Task Manually or Via Other Trigger

If you manually launch a Task Monitor task or launch it using a trigger other than a Task Monitor trigger, such as a Time trigger, the task continues running until its specified conditions are met. When that occurs, the Task Monitor goes to SUCCESS. No other processing occurs unless you have configured notifications with the task or set up some other task(s) to launch based on the status of this task.

The Task Monitor runs until one of the conditions described below occurs:

  • When the time window specified in the Task Monitor passes and the conditions in the Task Monitor are not met, the Task Monitor goes to a status of FAILED. If the time window is entirely in the past and the Controller does not locate the required event in the Activity table when the Task Monitor launches, the Task Monitor goes immediately to a FAILED status.
  • If no time window is specified in the Task Monitor and the Task Monitor conditions are not met, the Task Monitor task continues running.

Creating a Task Monitor Task

Step 1

From the Automation Center navigation pane, select Tasks > Task Monitor Tasks. The Task Monitor Tasks list displays a list of all currently defined Task Monitor tasks.
 
To the right of the list, Task Monitor Task Details for a new Task Monitor task displays.
 

Step 2

Enter/select Details for a new Task Monitor task, using the field descriptions below as a guide.

  • Required fields display an asterisk ( * ) after the field name.
  • Default values for fields, if available, display automatically.

To display more of the Details fields on the screen, you can either:

  • Use the scroll bar.
  • Temporarily hide the list above the Details.
  • Click the  button above the list to display a pop-up version of the Details.

Step 3

Click the  button. The task is added to the database, and all buttons and tabs in the Task Details are enabled.


Note
titleNote

To open an existing record on the list, either:

  • Click a record in the list to display its record Details below the list. (To clear record Details below the list, click the New button that displays above and below the Details.)
  • Clicking the Details icon next to a record name in the list, or right-click a record in the list and then click Open in the Action menu that displays, to display a pop-up version of the record Details.
  • Right-click a record in the a list, or open a record and right-click in the record Details, and then click Open In Tab in the Action menu that displays, to display the record Details under a new tab on the record list page (see Record Details as Tabs).

Anchor
Task Monitor Task Details
Task Monitor Task Details
Task Monitor Task Details

The following Task Monitor Task Details is for an existing Task Monitor task.

Depending on the values that you enter / select for these fields, and whether or not the Task Monitor task has ever been launched, more (or less) fields may display. See the field descriptions, below, for a description of all fields that may display in the Task Monitor Task Details.
 

Task Monitor Task Details Field Descriptions

The following table describes the fields, buttons, and tabs that display in the Task Monitor Task Details.

Field Name

Description

General

This section contains general information about the task.

Name

Include Page
IL:Task Name
IL:Task Name

Version

Include Page
IL:Versions
IL:Versions

Description

Include Page
IL:Summary
IL:Summary

Member of Business Services

Include Page
IL:Member of Business Services
IL:Member of Business Services

Resolve Name Immediately

Include Page
IL:Resolve Name Immediately
IL:Resolve Name Immediately

Time Zone Preference

Include Page
IL:Time Zone Preference
IL:Time Zone Preference

Hold on Start

Include Page
IL:Hold on Start
IL:Hold on Start

Hold Reason

Include Page
IL:Hold Reason
IL:Hold Reason

Virtual Resource Priority

Include Page
IL:Virtual Resource Priority
IL:Virtual Resource Priority

Anchor
Hold Resources on Failure
Hold Resources on Failure
Hold Resources on Failure

Include Page
IL:Hold Resources on Failure
IL:Hold Resources on Failure

Mutually Exclusive With Self

Include Page
IL:Mutually Exclusive With Self
IL:Mutually Exclusive With Self

Simulate 
Include Page
IL:Simulate
IL:Simulate

Monitor Details

This section contains assorted detailed information about the task.

Status To Monitor

Status being monitored for. When the task being monitored goes to a status specified in this field, the associated trigger is satisfied and the tasks specified in the trigger launch. You can specify as many statuses as needed (see Task Statuses).

Monitor Late StartSpecifies to monitor for an instance or instances that started late. When specifying a Time Scope, the instance Created Time must fall within the time window.
Monitor Late FinishSpecifies to monitor for an instance or instances that finished late. When specifying a Time Scope, the instance Created Time must fall within the time window.
Monitor Early FinishSpecifies to monitor for an instance or instances that finished early. When specifying a Time Scope, the instance Created Time must fall within the time window.

Anchor
Monitoring Type
Monitoring Type
Monitoring Type

Include Page
IL:Monitoring Type
IL:Monitoring Type

Anchor
Task to Monitor
Task to Monitor
Task to Monitor

Include Page
IL:Task to Monitor
IL:Task to Monitor

Anchor
Task Name Condition
Task Name Condition
Task Name Condition

Include Page
IL:Task Name Condition - 7.1.0.0
IL:Task Name Condition - 7.1.0.0

Anchor
Task Type to Monitor
Task Type to Monitor
Task Type to Monitor

Include Page
IL:Task Type to Monitor
IL:Task Type to Monitor

Anchor
Task Name Starts With
Task Name Starts With
Name Starts With

Required if Task Name Condition = Starts With; Character string at the start of the name of a task or tasks being monitored for.

Anchor
Task Name Contains
Task Name Contains
Name Contains

Required if Task Name Condition = Contains; Character string in the name of a task or tasks being monitored for.

Anchor
Task Name Ends With
Task Name Ends With
Name Ends With

Required if Task Name Condition = Ends With; Character string at the end of the name of a task or tasks being monitored for.

Anchor
Task Name Equals
Task Name Equals
Name Equals

Required if Task Name Condition = Equals; Character string equaling the name of a task or tasks being monitored for.

Anchor
Task Name Wildcard
Task Name Wildcard
Name Wildcard

Required if Task Name Condition = Wildcard; Character string equaling the name of a wildcard in a task or tasks being monitored for.

Anchor
Resolve Task Name Condition
Resolve Task Name Condition
Resolve Task Name Condition

If Monitoring Type = Generals Task(s) and Task Name Condition = Starts With, Contains, Ends With, or Equals; Specification (true or false) for whether or not to resolve at run time any variables in the task name of the task(s) being monitored.
 
Default is false.

Anchor
Workflow Name Condition
Workflow Name Condition
Workflow Name Condition

Include Page
IL:Workflow Condition
IL:Workflow Condition

Anchor
Workflow Name Equals
Workflow Name Equals
Workflow Name Equals

Optional if Workflow Name Condition = Equals; Exact name of a workflow or workflows containing the task being monitored for. If the field is blank, the Task Monitor will consider a Task Instance for a match only if the Task Instance is not contained within a workflow.

Anchor
Workflow Name Starts With
Workflow Name Starts With
Workflow Name Starts With

Required if Workflow Name Condition = Starts With; Character string at the start of the name of a workflow or workflows containing the task being monitored for.

Anchor
Workflow Name Contains
Workflow Name Contains
Workflow Name Contains

Required if Workflow Name Condition = Contains; Character string in the name of a workflow or workflows containing the task being monitored for.

Anchor
Workflow Name Ends With
Workflow Name Ends With
Workflow Name Ends With

Required if Workflow Name Condition = Ends With; Character string at the end of the name of a workflow or workflows containing the task being monitored for.

Anchor
Workflow Name Wildcard
Workflow Name Wildcard
Workflow Name Wildcard

Required if Workflow Name Condition = Ends With; Character string of a wildcard in the name of a workflow or workflows containing the task being monitored for.

Anchor
Time Scope
Time Scope
Time Scope

Include Page
IL:Time Scope - 7.2.0.0
IL:Time Scope - 7.2.0.0

Anchor
Expiration Action
Expiration Action
Expiration Action

Include Page
IL:Expiration Action - 7.2.0.0
IL:Expiration Action - 7.2.0.0

Anchor
From
From
From 

Include Page
IL:Time Scope From - 7.2.0.0
IL:Time Scope From - 7.2.0.0

Anchor
To
To
To

Include Page
IL:Time Scope To - 7.2.0.0
IL:Time Scope To - 7.2.0.0

Wait / Delay Options

This section contains specifications for waiting to start and/or delaying on start the task.

Anchor
Wait To Start
Wait To Start
Wait To Start

Include Page
IL:Wait To Start - 6.2.1.0
IL:Wait To Start - 6.2.1.0

Anchor
Wait Time
Wait Time
Wait Time

Include Page
IL:Wait Time - 6.2.1.0
IL:Wait Time - 6.2.1.0

Anchor
Wait Day Constraint
Wait Day Constraint
Wait Day Constraint

Include Page
IL:Wait Day Constraint
IL:Wait Day Constraint

Anchor
Wait Duration
Wait Duration
Wait Duration

Include Page
IL:Wait Duration
IL:Wait Duration

Anchor
Wait Duration In Seconds
Wait Duration In Seconds
Wait Duration In Seconds

Include Page
IL:Wait Duration In Seconds
IL:Wait Duration In Seconds

Anchor
Delay On Start
Delay On Start
Delay On Start

Include Page
IL:Delay On Start
IL:Delay On Start

Anchor
Delay Duration
Delay Duration
Delay Duration

Include Page
IL:Delay Duration
IL:Delay Duration

Anchor
Delay Duration In Seconds
Delay Duration In Seconds
Delay Duration In Seconds

Include Page
IL:Delay Duration In Seconds
IL:Delay Duration In Seconds

Anchor
Workflow Only
Workflow Only
Workflow Only

Include Page
IL:Workflow Only
IL:Workflow Only

Time Options

This section contains time-related specifications for task instances of the task.

Anchor
Late Start
Late Start
Late Start

Include Page
IL:Late Start
IL:Late Start

Anchor
Late Start Type
Late Start Type
Late Start Type

Include Page
IL:Late Start Type
IL:Late Start Type

Anchor
Late Start Time
Late Start Time
Late Start Time

Include Page
IL:Late Start Time
IL:Late Start Time

Anchor
Late Start Day Constraint
Late Start Day Constraint
Late Start Day Constraint

Include Page
IL:Late Start Day Constraint
IL:Late Start Day Constraint

Anchor
Late Start Nth Amount
Late Start Nth Amount
Late Start Nth Amount

Include Page
IL:Late Start Nth Amount
IL:Late Start Nth Amount

Anchor
Late Start Duration
Late Start Duration
Late Start Duration

Include Page
IL:Late Start Duration - NEW
IL:Late Start Duration - NEW

Anchor
Late Finish
Late Finish
Late Finish

Include Page
IL:Late Finish
IL:Late Finish

Anchor
Late Finish Type
Late Finish Type
Late Finish Type

Include Page
IL:Late Finish Type
IL:Late Finish Type

Anchor
Late Finish Offset Type
Late Finish Offset Type
Late Finish Offset Type

Include Page
IL:Late Finish Offset Type
IL:Late Finish Offset Type

Anchor
Late Finish Percentage Offset ( + )
Late Finish Percentage Offset ( + )
Late Finish Percentage Offset ( + )

Include Page
IL:Late Finish Percentage Offset ( + )
IL:Late Finish Percentage Offset ( + )

Anchor
Late Finish Duration Offset ( + )
Late Finish Duration Offset ( + )
Late Finish Duration Offset ( + )

Include Page
IL:Late Finish Duration Offset ( + )
IL:Late Finish Duration Offset ( + )

Anchor
Late Finish Duration Offset Unit
Late Finish Duration Offset Unit
Late Finish Duration Offset Unit

Include Page
IL:Late Finish Duration Offset Unit
IL:Late Finish Duration Offset Unit

Anchor
Late Finish Time
Late Finish Time
Late Finish Time

Include Page
IL:Late Finish Time
IL:Late Finish Time

Anchor
Late Finish Day Constraint
Late Finish Day Constraint
Late Finish Day Constraint

Include Page
IL:Late Finish Day Constraint
IL:Late Finish Day Constraint

Anchor
Late Finish Nth Amount
Late Finish Nth Amount
Late Finish Nth Amount

Include Page
IL:Late Finish Nth Amount
IL:Late Finish Nth Amount

Anchor
Late Finish Duration
Late Finish Duration
Late Finish Duration

Include Page
IL:Late Finish Duration - NEW
IL:Late Finish Duration - NEW

Anchor
Early Finish
Early Finish
Early Finish

Include Page
IL:Early Finish
IL:Early Finish

Anchor
Early Finish Type
Early Finish Type
Early Finish Type

Include Page
IL:Early Finish Type
IL:Early Finish Type

Anchor
Early Finish Offset Type
Early Finish Offset Type
Early Finish Offset Type

Include Page
IL:Early Finish Offset Type
IL:Early Finish Offset Type

Anchor
Early Finish Percentage Offset ( - )
Early Finish Percentage Offset ( - )
Early Finish Percentage Offset ( - )

Include Page
IL:Early Finish Percentage Offset ( - )
IL:Early Finish Percentage Offset ( - )

Anchor
Early Finish Duration Offset ( - )
Early Finish Duration Offset ( - )
Early Finish Duration Offset ( - )

Include Page
IL:Early Finish Duration Offset ( - )
IL:Early Finish Duration Offset ( - )

Anchor
Early Finish Duration Offset Unit
Early Finish Duration Offset Unit
Early Finish Duration Offset Unit

Include Page
IL:Early Finish Duration Offset Unit
IL:Early Finish Duration Offset Unit

Anchor
Early Finish Time
Early Finish Time
Early Finish Time

Include Page
IL:Early Finish Time
IL:Early Finish Time

Anchor
Early Finish Day Constraint
Early Finish Day Constraint
Early Finish Day Constraint

Include Page
IL:Early Finish Day Constraint
IL:Early Finish Day Constraint

Anchor
Early Finish Nth Amount
Early Finish Nth Amount
Early Finish Nth Amount

Include Page
IL:Early Finish Nth Amount
IL:Early Finish Nth Amount

Anchor
Early Finish Duration
Early Finish Duration
Early Finish Duration

Include Page
IL:Early Finish Duration - NEW
IL:Early Finish Duration - NEW

Anchor
User Estimated Duration
User Estimated Duration
User Estimated Duration

Include Page
IL:User Estimated Duration
IL:User Estimated Duration

Critical Path Options

This section contains Critical Path-related specifications for the task.

Anchor
CP Duration
CP Duration
CP Duration

Include Page
IL:CP Duration
IL:CP Duration

Anchor
CP Duration (Resolved)
CP Duration (Resolved)
CP Duration (Resolved)

Include Page
IL:CP Duration (Resolved)
IL:CP Duration (Resolved)

Anchor
CP Duration Unit
CP Duration Unit
CP Duration Unit

Include Page
IL:CP Duration Unit
IL:CP Duration Unit

Workflow Execution Options

This section contains Execution Restriction specifications for the task if it is within a Workflow.

Anchor
Execution Restriction
Execution Restriction
Execution Restriction

Include Page
IL:Execution Restriction
IL:Execution Restriction

Anchor
Restriction Period
Restriction Period
Restriction Period

Include Page
IL:Restriction Period
IL:Restriction Period

Anchor
Before Date
Before Date
Before Date

Include Page
IL:Before Date
IL:Before Date

Anchor
Before Time
Before Time
Before Time

Include Page
IL:Before Time
IL:Before Time

Anchor
After Date
After Date
After Date

Include Page
IL:After Date
IL:After Date

Anchor
After Time
After Time
After Time

Include Page
IL:After Time
IL:After Time

Anchor
Date List
Date List
Date List

Include Page
IL:Date List
IL:Date List

Statistics

This section contains time-related statistics for task instances of the task.

First Execution

Include Page
IL:First Execution
IL:First Execution

Last Execution

Include Page
IL:Last Execution
IL:Last Execution

Last Instance Duration

Include Page
IL:Last Instance Duration
IL:Last Instance Duration

Lowest Instance Time

Include Page
IL:Lowest Instance Time
IL:Lowest Instance Time

Average Instance Time

Include Page
IL:Average Instance Time
IL:Average Instance Time

Highest Instance Time

Include Page
IL:Highest Instance Time
IL:Highest Instance Time

Number of Instances

Include Page
IL:Number of Instances
IL:Number of Instances

Metadata

This section contains Metadata information about this record.

UUID

Universally Unique Identifier of this record.

Updated By

Name of the user that last updated this record.

Updated

Date and time that this record was last updated.

Created By

Name of the user that created this record.

Created

Date and time that this record was created.

Buttons

This section identifies the buttons displayed above and below the Task Details that let you perform various actions.

Save

Saves a new task record in the Controller database.

Save & New

Saves a new record in the Controller database and redisplays empty Details so that you can create another new record.

Save & View

Saves a new record in the Controller database and continues to display that record.

New

Displays empty (except for default values) Details for creating a new task.

Update

Include Page
IL:Update button
IL:Update button

Launch Task

Include Page
IL:Launch Task button
IL:Launch Task button

View Parents

Include Page
IL:View Parents button
IL:View Parents button

Copy

Creates a copy of this task, which you are prompted to rename.

Delete

Include Page
IL:Delete button
IL:Delete button

Note
titleNote

You cannot delete a task if it is either:

  • Specified in an enabled Trigger.
  • The only task specified in a disabled Trigger.


Refresh

Refreshes any dynamic data displayed in the Details.

Close

For pop-up view only; closes the pop-up view of this task.

Tabs

This section identifies the tabs across the top of the Task Details that provide access to additional information about the task.

Variables

Include Page
IL:Variables tab
IL:Variables tab

Actions

Include Page
IL:Actions tab
IL:Actions tab

Virtual Resources

Include Page
IL:Task Virtual Resources tab - 6.7.0.0
IL:Task Virtual Resources tab - 6.7.0.0

Mutually Exclusive

Include Page
IL:Mutually Exclusive Tasks tab
IL:Mutually Exclusive Tasks tab

Anchor
Instances tab
Instances tab
Instances

Lists all instances of the task.

Task Monitor Triggers

Include Page
IL:Task Monitor Triggers tab
IL:Task Monitor Triggers tab

Triggers

Include Page
IL:Triggers tab
IL:Triggers tab

Notes

Include Page
IL:Notes tab
IL:Notes tab

Anchor
Versions tab
Versions tab
Versions

Include Page
IL:Versions tab
IL:Versions tab

Anchor
Viewing a Task Monitor Task Instance
Viewing a Task Monitor Task Instance
Viewing a Task Monitor Task Instance

When a Task Monitor task is launched, the Controller creates a task instance record of that task.

A task instance contains detailed information about a single execution of that task.

You can access a task instance from:

Anchor
Task Monitor Task Instance Details
Task Monitor Task Instance Details
Task Monitor Task Instance Details

The following Task Monitor Task Instance Details contains information on the execution of the task shown in the Task Monitor Task Details.


 


Task Monitor Task Instance Details Field Descriptions

The following table describes the fields, buttons, and tabs that display in Task Monitor Task Instance Details.

Field Name

Description

General

This section contains general information about the task instance.

Anchor
Instance Name
Instance Name
Instance Name

Name of this task instance.

Instance Number

Include Page
IL:Instance Number
IL:Instance Number

Description

Include Page
IL:Summary
IL:Summary

Member of Business Services

Include Page
IL:Member of Business Services
IL:Member of Business Services

Task

Include Page
IL:Task
IL:Task

Source Version

Include Page
IL:Source Version
IL:Source Version

Launch Source

Include Page
IL:Launch Source
IL:Launch Source

Source Instance

Include Page
IL:Source Instance
IL:Source Instance

Invoked by

Include Page
IL:Invoked by
IL:Invoked by

Anchor
Execution User
Execution User
Execution User

Include Page
IL:Execution User
IL:Execution User

Calendar

Include Page
IL:Calendar in Task Instance
IL:Calendar in Task Instance

Time Zone Preference

Include Page
IL:Time Zone Preference
IL:Time Zone Preference

Virtual Resource Priority

Include Page
IL:Virtual Resource Priority
IL:Virtual Resource Priority

Anchor
Hold Resources on Failure
Hold Resources on Failure
Hold Resources on Failure

Include Page
IL:Hold Resources on Failure
IL:Hold Resources on Failure

Mutually Exclusive With Self

Include Page
IL:Mutually Exclusive With Self
IL:Mutually Exclusive With Self

Simulate 
Include Page
IL:Simulate
IL:Simulate

Status

This section contains information about the current status of the task instance.

Status

Include Page
IL:Status
IL:Status

Exit Code

Include Page
IL:Exit Code-Task Instance
IL:Exit Code-Task Instance

Status Description

Include Page
IL:Status Description
IL:Status Description

Operational Memo

Include Page
IL:Operational Memo
IL:Operational Memo

Evaluation Time

Include Page
IL:Evaluation Time
IL:Evaluation Time

Critical

Include Page
IL:Critical
IL:Critical

Critical Endpoint 

Include Page
IL:Critical Endpoint
IL:Critical Endpoint

Wait Until Time

Include Page
IL:Wait Until Time - Status
IL:Wait Until Time - Status

Queued Time

Include Page
IL:Queued Time
IL:Queued Time

Anchor
Trigger Time
Trigger Time
Trigger Time

Include Page
IL:Trigger Time
IL:Trigger Time

Anchor
Launch Time
Launch Time
Launch Time

Include Page
IL:Launch Time
IL:Launch Time

Anchor
Start Time
Start Time
Start Time

Include Page
IL:Start Time
IL:Start Time

End Time

Include Page
IL:End Time
IL:End Time

Duration

Include Page
IL:Duration
IL:Duration

Trigger

Trigger, if any, on whose behalf the Task Monitor task is monitoring other tasks.

Task Instance Matched

Last task that matched the specifications of the task(s) being monitored.

Monitor Details

This section contains assorted detailed information about the task instance.

Status To Monitor

Status being monitored for. When the task being monitored goes to a status specified in this field, the associated trigger is satisfied and the tasks specified in the trigger launch. You can specify as many statuses as needed (see Task Statuses).

Monitor Late StartSpecifies to monitor for an instance or instances that started late. When specifying a Time Scope, the instance Created Time must fall within the time window.
Monitor Late FinishSpecifies to monitor for an instance or instances that finished late. When specifying a Time Scope, the instance Created Time must fall within the time window.
Monitor Early FinishSpecifies to monitor for an instance or instances that finished early. When specifying a Time Scope, the instance Created Time must fall within the time window.

Anchor
Monitoring Type
Monitoring Type
Monitoring Type

Include Page
IL:Monitoring Type
IL:Monitoring Type

Anchor
Task to Monitor
Task to Monitor
Task to Monitor

Include Page
IL:Task to Monitor
IL:Task to Monitor

Anchor
Task Name Condition
Task Name Condition
Task Name Condition

Include Page
IL:Task Name Condition - 7.1.0.0
IL:Task Name Condition - 7.1.0.0

Anchor
Task Type to Monitor
Task Type to Monitor
Task Type to Monitor

Include Page
IL:Task Type to Monitor
IL:Task Type to Monitor

Anchor
Task Name Starts With
Task Name Starts With
Name Starts With

Required if Task Name Condition = Starts With; Character string at the start of the name of a task or tasks being monitored for.

Anchor
Task Name Contains
Task Name Contains
Name Contains

Required if Task Name Condition = Contains; Character string in the name of a task or tasks being monitored for.

Anchor
Task Name Ends With
Task Name Ends With
Name Ends With

Required if Task Name Condition = Ends With; Character string at the end of the name of a task or tasks being monitored for.

Anchor
Task Name Equals
Task Name Equals
Name Equals

Required if Task Name Condition = Equals; Character string equaling the name of a task or tasks being monitored for.

Anchor
Task Name Wildcard
Task Name Wildcard
Name Wildcard

Required if Task Name Condition = Wildcard; Character string equaling the name of a wildcard in a task or tasks being monitored for.

Anchor
Resolve Task Name Condition
Resolve Task Name Condition
Resolve Task Name Condition

If Monitoring Type = Generals Task(s) and Task Name Condition = Starts With, Contains, Ends With, or Equals; Specification (true or false) for whether or not to resolve at run time any variables in the task name of the task(s) being monitored.
 
Default is false.

Anchor
Workflow Name Condition
Workflow Name Condition
Workflow Name Condition

Include Page
IL:Workflow Condition
IL:Workflow Condition

Anchor
Workflow Name Equals
Workflow Name Equals
Workflow Name Equals

Optional if Workflow Name Condition = Equals; Exact name of a workflow or workflows containing the task being monitored for. If the field is blank, the Task Monitor will consider a Task Instance for a match only if the Task Instance is not contained within a workflow.

Anchor
Workflow Name Starts With
Workflow Name Starts With
Workflow Name Starts With

Required if Workflow Name Condition = Starts With; Character string at the start of the name of a workflow or workflows containing the task being monitored for.

Anchor
Workflow Name Contains
Workflow Name Contains
Workflow Name Contains

Required if Workflow Name Condition = Contains; Character string in the name of a workflow or workflows containing the task being monitored for.

Anchor
Workflow Name Ends With
Workflow Name Ends With
Workflow Name Ends With

Required if Workflow Name Condition = Ends With; Character string at the end of the name of a workflow or workflows containing the task being monitored for.

Anchor
Workflow Name Wildcard
Workflow Name Wildcard
Workflow Name Wildcard

Required if Workflow Name Condition = Ends With; Character string of a wildcard in the name of a workflow or workflows containing the task being monitored for.

Anchor
Time Scope
Time Scope
Time Scope

Include Page
IL:Time Scope - 7.2.0.0
IL:Time Scope - 7.2.0.0

Anchor
Expiration Action
Expiration Action
Expiration Action

Include Page
IL:Expiration Action - 7.2.0.0
IL:Expiration Action - 7.2.0.0

Anchor
From
From
From

Include Page
IL:Time Scope From - 7.2.0.0
IL:Time Scope From - 7.2.0.0

Anchor
To
To
To

Include Page
IL:Time Scope To - 7.2.0.0
IL:Time Scope To - 7.2.0.0

Wait / Delay Options

This section contains specifications for waiting to start and/or delaying on start the task.

Anchor
Wait To Start
Wait To Start
Wait To Start

Include Page
IL:Wait To Start - 6.2.1.0
IL:Wait To Start - 6.2.1.0

Anchor
Wait Time
Wait Time
Wait Time

Include Page
IL:Wait Time - 6.2.1.0
IL:Wait Time - 6.2.1.0

Anchor
Wait Day Constraint
Wait Day Constraint
Wait Day Constraint

Include Page
IL:Wait Day Constraint
IL:Wait Day Constraint

Anchor
Wait Duration
Wait Duration
Wait Duration

Include Page
IL:Wait Duration
IL:Wait Duration

Anchor
Wait Duration In Seconds
Wait Duration In Seconds
Wait Duration In Seconds

Include Page
IL:Wait Duration In Seconds
IL:Wait Duration In Seconds

Anchor
Delay On Start
Delay On Start
Delay On Start

Include Page
IL:Delay On Start
IL:Delay On Start

Anchor
Delay Duration
Delay Duration
Delay Duration

Include Page
IL:Delay Duration
IL:Delay Duration

Anchor
Delay Duration In Seconds
Delay Duration In Seconds
Delay Duration In Seconds

Include Page
IL:Delay Duration In Seconds
IL:Delay Duration In Seconds

Time Options

This section contains time-related specifications for the task instance.

Anchor
Late Start
Late Start
Late Start

Include Page
IL:Late Start
IL:Late Start

Anchor
Started Late
Started Late
Started Late

Include Page
IL:Started Late
IL:Started Late

Anchor
Late Start Type
Late Start Type
Late Start Type

Include Page
IL:Late Start Type
IL:Late Start Type

Anchor
Late Start Time
Late Start Time
Late Start Time

Include Page
IL:Late Start Time
IL:Late Start Time

Anchor
Late Start Day Constraint
Late Start Day Constraint
Late Start Day Constraint

Include Page
IL:Late Start Day Constraint
IL:Late Start Day Constraint

Anchor
Late Start Nth Amount
Late Start Nth Amount
Late Start Nth Amount

Include Page
IL:Late Start Nth Amount
IL:Late Start Nth Amount

Anchor
Late Start Duration
Late Start Duration
Late Start Duration

Include Page
IL:Late Start Duration - NEW
IL:Late Start Duration - NEW

Anchor
Computed Late Start Time
Computed Late Start Time
Computed Late Start Time

Include Page
IL:Computed Late Start Time
IL:Computed Late Start Time

Anchor
Late Finish
Late Finish
Late Finish

Include Page
IL:Late Finish
IL:Late Finish

Anchor
Finished Late
Finished Late
Finished Late

Include Page
IL:Finished Late
IL:Finished Late

Anchor
Late Finish Type
Late Finish Type
Late Finish Type

Include Page
IL:Late Finish Type
IL:Late Finish Type

Anchor
Late Finish Offset Type
Late Finish Offset Type
Late Finish Offset Type

Include Page
IL:Late Finish Offset Type
IL:Late Finish Offset Type

Anchor
Late Finish Percentage Offset ( + )
Late Finish Percentage Offset ( + )
Late Finish Percentage Offset ( + )

Include Page
IL:Late Finish Percentage Offset ( + )
IL:Late Finish Percentage Offset ( + )

Anchor
Late Finish Duration Offset ( + )
Late Finish Duration Offset ( + )
Late Finish Duration Offset ( + )

Include Page
IL:Late Finish Duration Offset ( + )
IL:Late Finish Duration Offset ( + )

Anchor
Late Finish Duration Offset Unit
Late Finish Duration Offset Unit
Late Finish Duration Offset Unit

Include Page
IL:Late Finish Duration Offset Unit
IL:Late Finish Duration Offset Unit

Anchor
Late Finish Time
Late Finish Time
Late Finish Time

Include Page
IL:Late Finish Time
IL:Late Finish Time

Anchor
Late Finish Day Constraint
Late Finish Day Constraint
Late Finish Day Constraint

Include Page
IL:Late Finish Day Constraint
IL:Late Finish Day Constraint

Anchor
Late Finish Nth Amount
Late Finish Nth Amount
Late Finish Nth Amount

Include Page
IL:Late Finish Nth Amount
IL:Late Finish Nth Amount

Anchor
Late Finish Duration
Late Finish Duration
Late Finish Duration

Include Page
IL:Late Finish Duration - NEW
IL:Late Finish Duration - NEW

Anchor
Computed Late Finish Time
Computed Late Finish Time
Computed Late Finish Time

Include Page
IL:Computed Late Finish Time
IL:Computed Late Finish Time

Anchor
Early Finish
Early Finish
Early Finish

Include Page
IL:Early Finish
IL:Early Finish

Anchor
Finished Early
Finished Early
Finished Early

Include Page
IL:Finished Early
IL:Finished Early

Anchor
Early Finish Type
Early Finish Type
Early Finish Type

Include Page
IL:Early Finish Type
IL:Early Finish Type

Anchor
Early Finish Offset Type
Early Finish Offset Type
Early Finish Offset Type

Include Page
IL:Early Finish Offset Type
IL:Early Finish Offset Type

Anchor
Early Finish Percentage Offset ( - )
Early Finish Percentage Offset ( - )
Early Finish Percentage Offset ( - )

Include Page
IL:Early Finish Percentage Offset ( - )
IL:Early Finish Percentage Offset ( - )

Anchor
Early Finish Duration Offset ( - )
Early Finish Duration Offset ( - )
Early Finish Duration Offset ( - )

Include Page
IL:Early Finish Duration Offset ( - )
IL:Early Finish Duration Offset ( - )

Anchor
Early Finish Duration Offset Unit
Early Finish Duration Offset Unit
Early Finish Duration Offset Unit

Include Page
IL:Early Finish Duration Offset Unit
IL:Early Finish Duration Offset Unit

Anchor
Early Finish Time
Early Finish Time
Early Finish Time

Include Page
IL:Early Finish Time
IL:Early Finish Time

Anchor
Early Finish Day Constraint
Early Finish Day Constraint
Early Finish Day Constraint

Include Page
IL:Early Finish Day Constraint
IL:Early Finish Day Constraint

Anchor
Early Finish Nth Amount
Early Finish Nth Amount
Early Finish Nth Amount

Include Page
IL:Early Finish Nth Amount
IL:Early Finish Nth Amount

Anchor
Early Finish Duration
Early Finish Duration
Early Finish Duration

Include Page
IL:Early Finish Duration - NEW
IL:Early Finish Duration - NEW

Anchor
User Estimated Duration
User Estimated Duration
User Estimated Duration

Include Page
IL:User Estimated Duration
IL:User Estimated Duration

Anchor
Projected Late
Projected Late
Projected Late

Include Page
IL:Projected Late - 6.9.0.0
IL:Projected Late - 6.9.0.0

Critical Path Options

This section contains Critical Path-related specifications for the task.

Anchor
CP Duration
CP Duration
CP Duration

Include Page
IL:CP Duration
IL:CP Duration

Anchor
CP Duration (Resolved)
CP Duration (Resolved)
CP Duration (Resolved)

Include Page
IL:CP Duration (Resolved)
IL:CP Duration (Resolved)

Anchor
CP Duration Unit
CP Duration Unit
CP Duration Unit

Include Page
IL:CP Duration Unit
IL:CP Duration Unit

Workflow Execution Options

This section contains Execution Restriction specifications for the task if it is within a Workflow.

Anchor
Execution Restriction
Execution Restriction
Execution Restriction

Include Page
IL:Execution Restriction
IL:Execution Restriction

Anchor
Restriction Period
Restriction Period
Restriction Period

Include Page
IL:Restriction Period
IL:Restriction Period

Anchor
Before Date
Before Date
Before Date

Include Page
IL:Before Date
IL:Before Date

Anchor
Before Time
Before Time
Before Time

Include Page
IL:Before Time
IL:Before Time

Anchor
After Date
After Date
After Date

Include Page
IL:After Date
IL:After Date

Anchor
After Time
After Time
After Time

Include Page
IL:After Time
IL:After Time

Anchor
Date List
Date List
Date List

Include Page
IL:Date List
IL:Date List

Statistics

This section contains time-related statistics for the task instance.

Anchor
User Estimated End Time
User Estimated End Time
User Estimated End Time

Include Page
IL:User Estimated End Time
IL:User Estimated End Time

Lowest Estimated End Time

Include Page
IL:Lowest Estimated End Time
IL:Lowest Estimated End Time

Average Estimated End Time

Include Page
IL:Average Estimated End Time
IL:Average Estimated End Time

Highest Estimated End Time

Include Page
IL:Highest Estimated End Time
IL:Highest Estimated End Time

Projected Start Time

Include Page
IL:Projected Start Time
IL:Projected Start Time

Projected End Time

System-supplied; projected end time of the task instance, calculated by the Controller based on the projected end time of its predecessor (or the maximum projected end time of all its predecessors, if more than one path exists to that task instance) plus its estimated critical path duration.

Metadata

This section contains Metadata information about this record.

UUID

Universally Unique Identifier of this record.

Updated By

Name of the user that last updated this record.

Updated

Date and time that this record was last updated.

Created By

Name of the user that created this record.

Created

Date and time that this record was created.

Status History

History of all statuses that the task instance has gone through.

Buttons

This section identifies the buttons displayed above and below the Task Instance Details that let you perform various actions.

Update

Include Page
IL:Update button
IL:Update button

Force Finish

Include Page
IL:Force Finish button
IL:Force Finish button

Hold

Include Page
IL:Hold button
IL:Hold button

Skip

Include Page
IL:Skip button
IL:Skip button

Re-run

Include Page
IL:Re-run button
IL:Re-run button

View Parent

Include Page
IL:View Parent button
IL:View Parent button

Delete

Include Page
IL:Delete button
IL:Delete button

Anchor
View Potential Matches
View Potential Matches
View Potential Matches

Include Page
IL:View Potential Matches button
IL:View Potential Matches button

Refresh

Refreshes any dynamic data displayed in the Details.

Close

For pop-up view only; closes the pop-up view of this task instance.

Delete

Include Page
IL:Delete button
IL:Delete button

Tabs

This section identifies the tabs across the top of the Task Instance Details that provide access to additional information about the task instance.

Actions
Include Page
IL:Actions Tab - Instance
IL:Actions Tab - Instance

Virtual Resources

Include Page
IL:Task Virtual Resources tab - 6.7.0.0
IL:Task Virtual Resources tab - 6.7.0.0

Exclusive Requests

Include Page
IL:Exclusive Requests tab
IL:Exclusive Requests tab

Notes

Include Page
IL:Notes tab
IL:Notes tab

Anchor
Viewing Potential Matches
Viewing Potential Matches

Viewing Potential Matches for a Running Task Monitor Task Instance

To view a list of running task instances that have the potential to match the specifications for tasks being monitored by the running Task Monitor task instance:

Step 1

Either:

  • From the Activity Monitor or Task Instances list, right-click the the running Task Monitor task instance and select View Potential Matches from the Action Menu.
  • Open the running Task Monitor task instance and click the View Potential Matches button or right-click in the task instance Details and select View Potential Matches from the Action Menu.
  • If the running Task Monitor task instance is part of a Workflow, right-click the task instance in the Workflow Monitor and select View Potential Matches from the menu.

Step 2

On the View Potential Matches pop-up dialog, select a date and click Submit.
 

Step 3

A list of all potential matches displays in a new tab.
 

Step 4

Click Print to print a hard copy of the list or Refresh to refresh the task instances on the list.

Monitoring Task Execution

You can monitor all system activity from the Activity Monitor and can view activity history from the History list.

Anchor
Understanding Relative Time Scope
Understanding Relative Time Scope

Understanding Relative Time Scope

For any relative Time Scope conditions within the past, a Task Monitor will analyze only the current content of the database; specifically, by using the Status (ops_exec."status_code") and the State Changed Time (ops_exec."state_changed_time") to determine potential matches from the time window in the past.

Consider a Task Monitor instance monitoring for a Failed status within a time window in the past. If a potential task instance has a current status of Failed, the current State Changed Time will indicate when that task instance transitioned to the Failed status. When the Task Monitor instance runs, any task instance with a matching Status, and a State Changed Time within the time window in the past, can be considered for a match.
 

Note
titleNote

The Task Monitor instance will consider only the current content (that is, current Status and current State Changed Time) of the All Task Instances (ops_exec) table when searching for qualifying task instances that match within a time window in the past.


Revisiting the example above, if you had a task instance with a status of Failed within the time window in the past, but prior to the Task Monitor instance running, the task instance was Finished, it would no longer be considered for a match.

Be aware that when specified, the Time Scope is relative to the time that the Task Monitor instance runs.

For example, consider the following Task Monitor instance:

Field

Value

Start Time

2017-11-02 15:05:00 -0400

From

-6:00

To 

-2:00

Status To Monitor

Success

Task To Monitor

Sleep 0

For the relative Time Scope specified above, with a time window in the past, this would translate into the following query, paying particular attention to how the relative times are computed.

Panel
SELECT * FROM ops_exec WHERE "state_changed_time" >= '2017-11-02 09:05:00 -0400' AND "state_changed_time" <= '2017-11-02 13:05:00 -0400' AND "status_code" = '200' AND "task_id" = '410d6c0bc0a801c901838d8ac43b3279'