Task Scheduler: Task List and Running Tasks

System > Task Scheduler opens the task list. It shows all tasks, their state and the time of the last scheduler call.

Task Scheduler task list
Task list with Last Scheduler Start and Manual Start at the top

Columns and statuses

Column Meaning
Name Task name. The list can be sorted by Name or Priority.
Last Start Start time of the last run, or "Never". Click it to open the task statistics.
Status Idle, Working or In Progress (see below).
Completions How many times the task finished successfully.
Active Only active tasks run by schedule.
Priority See the tooltip next to the column name and Creating and Editing Tasks.
Action Edit (View in Lite), and Run or Stop.

Statuses:

  • Idle: the task waits for its next run.
  • Working: a step of the task is running now.
  • In Progress: a multi-step task has finished a step and waits for the next one.

Last Scheduler Start at the top shows the last call of the scheduler by cron or by hand. If it is "Never" or old, cron is not working, see Cron Setup.

Changing tasks from the list

  • Update saves the Active checkboxes and Priority values of all tasks on the page. Other task fields are not changed.
  • Delete deletes the selected tasks. There is no confirmation.
  • Edit opens the task form. In Lite it is View: a read-only page of the task.

These actions need the modify permission.

Running tasks by hand

  • Manual Start: Go calls the scheduler once in a new browser tab, like a cron call: it runs the next due task, or continues an unfinished one. When it is done, you see "The task scheduler run is complete. See the task status and statistics in the list."
  • Run (next to an Idle task) runs this task now, even if it is not due or not active. If another task is running at that moment, nothing is started.
  • A multi-step task continues step by step in the browser. Keep the tab open until it finishes.

Manual runs work without the key for users who have access to the module settings. Other users get "Warning: You do not have permission to run the Task Scheduler." See Permissions and Security.

Stopping a task

Stop appears for tasks in the Working or In Progress status. It aborts the task: the task returns to Idle and lets the task module clean up its own data. The task runs again at its next scheduled time. Stop needs the modify permission.

Task statistics

Click the Last Start value of a task to open Task Statistics. It shows the results of the last run reported by the task, for example "Updated currencies: USD, GBP" or "File size". The same values are sent in the completion email.

Task Statistics page of a Download file task
Task Statistics of a Download file task

Which task runs first

Each scheduler call runs one task:

  1. An unfinished task (Working or In Progress) is continued first. While it is working, other tasks wait.
  2. Otherwise the scheduler takes the active tasks whose Start After has passed and whose End At has not, and picks the first one that is due, in this order: the oldest last start first (never started tasks first), then the higher priority.
  3. When a task finishes, it may call another task (for example, Download file calls an import task). The called task runs right after it in the same call.

Do not make tasks call each other in a loop (task A calls task B, and B calls A): such tasks run without end.