Task & Job States

Tasks are a workflow abstraction; they represent future and past jobs as well as current active jobs. In the Cylc UI, task states have monochromatic icons like this: task-running.

Jobs represent real job scripts submitted to run on a job platform. In the Cylc UI, job states have coloured icons like this: job-running.

A single task can have multiple jobs, by automatic retry or manual triggering.

State

Task Icon

Job Icon

Description

waiting

task-waiting

waiting on prerequisites

preparing

task-preparing

job being prepared for submission

submitted

task-submitted

job-submitted

job submitted

running

task-running

job-running

job running

succeeded

task-succeeded

job-succeeded

job succeeded

failed

task-failed

job-failed

job failed

submit-failed

task-submit-failed

job-submit-failed

job submission failed

expired

task-expired

will not submit job (too far behind)

The running task icon contains a clock face which shows the time elapsed as a proportion of the average runtime.

../../_images/task-running-0.png ../../_images/task-running-25.png ../../_images/task-running-50.png ../../_images/task-running-75.png ../../_images/task-running-100.png


Task Modifiers

Tasks are run as soon as their dependencies are satisfied, however, there are some other conditional which can prevent tasks from being run. These are given “modifier” icons which appear to the top-left of the task icon:

../../_images/task-isHeld.png

Held: Task has been manually held back from running.

../../_images/task-isRunahead.png

Runahead: Task is held back by the runahead limit.

../../_images/task-isQueued.png

Queued: Task has been held back by an internal queue.