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
- Click New scheduled job in the panel toolbar
- Select the
.ocefile to run - Enter a cron expression for the schedule (see below)
- 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:
| Expression | Meaning |
|---|---|
0 9 * * 1-5 | 9: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:
| Action | What it does |
|---|---|
| Enable / Disable | Toggles whether the job fires on schedule |
| Edit schedule | Opens a prompt to enter a new cron expression |
| Run now | Queues the job immediately regardless of schedule |
| Delete | Removes 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.