Skip to content

Scheduled Runs

The Scheduled Jobs panel lets you run a .oce file automatically on a recurring schedule defined by a cron expression.

Opening the panel

Open the Scheduled Jobs panel from View → Scheduled Jobs in the menu bar, or from Run → Scheduled Jobs.

Creating a scheduled job

  1. Click New scheduled job in the panel toolbar
  2. Select the .oce file to run
  3. Enter a cron expression for the schedule (see below)
  4. Confirm — the job appears in the list and is enabled by default

Cron expressions

Scheduled Jobs uses standard five-field cron syntax:

┌──────────── minute (0–59)
│ ┌─────────── hour (0–23)
│ │ ┌──────────── day of month (1–31)
│ │ │ ┌─────────── month (1–12)
│ │ │ │ ┌──────────── day of week (0–7, 0 and 7 = Sunday)
│ │ │ │ │
* * * * *

Common examples:

ExpressionMeaning
0 9 * * 1-59:00 AM on weekdays
*/30 * * * *Every 30 minutes
0 0 * * *Midnight every day
0 8 1 * *8:00 AM on the 1st of each month

Managing jobs

Each row in the Scheduled Jobs panel shows the file name, cron expression, and enabled state. Row actions:

ActionWhat it does
Enable / DisableToggles whether the job fires on schedule
Edit scheduleOpens a prompt to enter a new cron expression
Run nowQueues the job immediately regardless of schedule
DeleteRemoves the job permanently

How scheduling works

The scheduler checks for due jobs every 60 seconds. A job is considered due if its cron expression matches the current minute and it is enabled. If the app is closed when a job was due, it is not retried — it fires at the next scheduled time.

Each firing is treated as a regular queued run. The output appears in the Console and Run History panels as normal.