commands – job schedule (calendar)
Add/delete a calendar job schedule.
Usage
job schedule (add|delete) name calendar n unit [(before|after)] [(start|end|both)]
job schedule (add|delete) name calendar n unit (inside|outside)
where
| add | add the specified schedule. |
| delete | delete the specified schedule. |
| name | of job whose schedule to add/delete. |
| n | Offset from calendar event boundary/s. Default = 0. |
| unit | of offset. Where unit is one of second[s], minute[s] or hour[s]. |
| before|after | run job n units before or after calendar event boundary. Default = before. |
| start|end|both | calendar event boundary/s to start job. Default = start. |
| outside | run job n units before start, and after end of each calendar event. |
| inside | run job n units after start, and before end of each calendar event. |
Calendar schedule boundaries and offset directions
| Boundary | Offset direction |
| 1 start of a calendar event. | 3 before event boundaries. |
| 2 end of a calendar event. | 4 after event boundaries. |
| 1 & 2 both. | 5 outside of event boundaries. |
| 6 inside of event boundaries. |
Calendar schedules ignore the job timezone and use the underlying icalendar timezones, except for
floating events.
write on name
Examples
Schedule a job to run 15 minutes before close of business
BeyondCron % job schedule add /store/closing calendar 15 minutes before end
BeyondCron % job show $$
----------- --------------------------------------------- Name /store/closing Description Play Auld Lang Syne as store closing reminder ... Calendar /calendars/store-hours ... Schedules calendar 15 minutes before end Command /usr/bin/afplay /music/auld-lang-syne.mp3 ...
Delete a calendar schedule
BeyondCron % job schedule delete /store/closing calendar 15 minutes before end
BeyondCron % job show $$
----------- --------------------------------------------- Name /store/closing Description Play Auld Lang Syne as store closing reminder ... Schedules ...
See also
- job schedule