Restart the currently running schedule, if any.

Arguments:

(none)

Example:

The following would restart the currently running schedule, if any, after first running any at_end statements, to cleanly terminate the aborted schedule.

  restart_schedule

Context:

When a schedule is running, this command allows it to be aborted and restarted, without the observer having to explicitly requeue it. What the command actually does is the equivalent of an abort_schedule command, followed by restarting the schedule from scratch. Note that this means that before the schedule restarts, the running schedule will first execute any at_end statements that the running schedule registered. Beware that if the schedule to be restarted is currently suspended, then the restart is postponed until the schedule is resumed.