Here is the answer:
The execute() method of Scheduler.RepeatingCommand returns a boolean.
If true, then the command will be invoked again. If false, it will be
cancelled.
public interface RepeatingCommand {
/**
* Returns true if the RepeatingCommand should be invoked again.
*/
boolean execute();