Advance a given schedule one or more entries in the schedule queue.

Arguments:

QueueEntry index

The queue index of the schedule to be moved.

Count number

The number of queue positions to advance the schedule.

Example:

The following example moves entry 2 in the queue of pending schedules to entry 0, displacing entries 0 and 1 to be executed after the specified script.

  advance_schedule 2, 2

Context:

The schedule command queues scheduling scripts to be executed in the order that they are queued. If it then turns out that one needs to execute a particular script ahead of others that are already in the queue, one can use the advance_schedule command to advance it towards the front of the queue. Note that this can also be done interactively in the topmost pane of the main cbiviewer window.