Loading the documentation…

Scheduled runs and history

Each time a scheduled task runs, its work happens in a new chat in the DataMind Oda desktop app. This page shows where runs appear, what the history records, why a run was skipped or stopped, and when Oda notifies you. To create or change a task, see Schedule recurring tasks.

Where a run appears

The Scheduled section in the sidebar

Run and manage a task from its row

How a run starts

While no one is watching

Runs are unattended, so a few things work differently from a chat you sit in:

Run statuses

A task starts one run at a time, and waiting runs start in the order they were queued. A slot that arrives while the previous run is still going is recorded as Skipped.

StatusWhat it means
QueuedThe run is waiting to start.
RunningThe run is going now.
DoneThe run finished, including a run that stopped at its output limit.
FailedThe run ended with an error; the history keeps the error's message.
SkippedThe slot did not start a run; the history names the reason.
AbortedThe run was stopped: it reached the task's time limit, or you stopped it.

Why a run was skipped or stopped

The history gives a reason for every run that did not go as planned:

Skipped slots are not caught up. When Oda comes back, a slot it reaches shortly after its time still runs, the newest missed slots are kept in the history, and nothing runs twice to catch up. Around daylight-saving changes, a local time the clock skips runs the same distance after the gap, and a time the clock repeats runs once, at its first occurrence.

For the wake setting, and how Oda wakes a sleeping computer, see Wake the computer for a scheduled run.

Notifications

Read and clear new results

Runs in the Activity panel

Reading the run history

  1. Open the task: click it under Scheduled, or use All runs → on its runs.
  2. Find the run in the history. Each row shows the time and its trigger (Scheduled or Run by hand), the status, the actions the run was denied (1 denied, or None), the duration (1 h 05 min), the tokens used (compact counts such as 12K), and the run's chat.
  3. Choose Open to read the run's chat, or Stop to stop a run that is going or queued. A Skipped row offers Run now while the task has no active run.

A task with no runs yet shows No runs yet.

Questions, answered

Where do I find the chat a run created?

Under Scheduled in the sidebar, inside its task, or in the task page's history. Opening a run opens its chat and marks the run read. Search names run chats Scheduled · <task>; they stay out of your workspace lists and folder pickers.

What do the times and words on a task row mean?

The next run appears as 09:00, Mon 09:00 or 6 Oct. Paused means the schedule is paused; Queued means one of its runs is waiting; 2 new counts results you have not opened; and a run in progress shows a live timer such as 03:12. Needs attention means the task itself has a problem; rest the pointer on the row to read it.

Why was my run skipped?

The history row names the reason. Common ones: the computer was asleep or Oda was closed at the slot's time, the previous run had not finished, or the task asks for Full access your account does not allow.

Are missed runs caught up later?

No. When Oda comes back, a slot it reaches shortly after its time still runs, but older missed slots stay as Skipped records, and a task never runs twice to catch up.

Why did my run stop before it finished?

Two causes: the run reached the task's time limit (the reason reads <n>-hour limit reached.), or you stopped it (Stopped by you.). To give long work more time, change the task's Time limit; see Schedule recurring tasks.

Can I stop a run myself?

Yes. A running or queued run offers Stop in its history row and in the Scheduled · across Oda band of the Activity panel. The history records it as Aborted, with the reason Stopped by you.

Why did my run fail?

The history keeps the error's message. Two common messages: Sign in required. when Oda was signed out (sign in again, then the next run works), and the Full access sentence when your account does not allow it. If the message is unexpected, keep it and contact your administrator; Troubleshooting lists common messages.

Which runs send a notification?

Failed and stopped runs always notify. A run that finishes notifies only when the task has Notify when a run finishes on. Skipped runs never notify, and clicking a notification opens the run's chat.

What do the prompt variables become when a run starts?

{{now}} and {{scheduledFor}} become the run's start time and its scheduled time, in your computer's time. {{lastSuccessfulRun}} becomes the time of the last successful run, and is empty before the first successful run. Variables Oda does not know stay as written.

Why does one task have no Pause button?

A Manual task runs only when you press Run now, so it has no schedule to pause. On other tasks, Pause or Resume turns unavailable while the task has a problem.

What happens to a run's chat after I delete its task?

The chat stays. It becomes an ordinary archived chat that Show archived lists again. A run you pinned stays pinned.

Why does the Scheduled section show an error instead of my tasks?

Oda could not read your task list; the message names the reason. Press Retry to load the list again.