hydra

Class ComplexTaskScheduler

java.lang.Object

hydra.BaseTaskScheduler

hydra.ComplexTaskScheduler

All Implemented Interfaces:

TaskScheduler

Direct Known Subclasses:

ComplexConcurrentTaskScheduler, ComplexRoundRobinTaskScheduler, ComplexSerialTaskScheduler

public abstract class ComplexTaskScheduler
extends BaseTaskScheduler

This class acts as the superclass for all complex task schedulers. These schedulers work with TASKs, which have a greater number of attributes than other types of hydra tasks.

TASKs that do not specify thread groups are assigned to the default group.

Field Summary

Fields inherited from class hydra.BaseTaskScheduler

disconnect, haltIfBadResult, log, name, purpose, tasks, termination, vms

Constructor Summary

Constructors

Constructor and Description
ComplexTaskScheduler(String name, Vector tasks, String purpose, long totalTaskTimeSec) Creates a task scheduler by the given name for the purpose of executing the given set of tasks.

Method Summary

Modifier and Type	Method and Description
protected boolean	exceededMaxResultWaitSec(long now) True if any clients are still busy and have run out of time.
protected boolean	hasTask(ClientRecord client, long now) returns whether the client has an eligible task
protected void	initializeTaskTimes() initializes the task start and end times
protected boolean	receivedStopSchedulingOrder() Returns true if a StopSchedulingOrder has been thrown.
protected void	receiveStopSchedulingOrder() Registers the fact that a StopSchedulingOrder has been thrown.
protected boolean	schedule(ClientRecord client, long now, ComplexTaskScheduler ts) Schedules the client with the task, after rechecking under synchronization that the client is still available for scheduling.
protected TestTask	selectTask(ClientRecord client, long now) selects the best eligible task for the client to run
protected boolean	terminateScheduling(int count, long now) True if it is time to stop scheduling clients.
protected void	waitForDynamicThreadsToFinish() Blocks until all dynamic scheduler threads have completed.

Methods inherited from class hydra.BaseTaskScheduler

assignTask, createClients, exceededMaxResultWaitSec, exceededMaxResultWaitSec, executedNormally, executedNormallyOrNoHaltOrder, executeTasks, executeTasks, fakeKillResults, getTsid, getVm, getVms, hadDynamicActionError, hadDynamicActionHang, hadFatalTaskErrorAndHaltOrder, hadStatMonitorError, initClientRuntime, initExecutionParameters, isFinished, pauseBlocking, pauseScheduling, pauseWaiting, printBlockingReport, printReport, printSchedulingReport, printWaitingReport, processDynamicActionError, reportResult, schedulerResult, setDynamicActionError, setDynamicActionHang, setStatMonitorError, setTermination, startClients, startClientsForced, stopClients, waitForClientsToFinish, waitForClientsToFinish, waitForClientToFinish

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ComplexTaskScheduler

public ComplexTaskScheduler(String name,
                            Vector tasks,
                            String purpose,
                            long totalTaskTimeSec)

Creates a task scheduler by the given name for the purpose of executing the given set of tasks.

Parameters:

name - a descriptive name of the tasks to use for logging

tasks - the tasks to be scheduled

totalTaskTimeSec - total amount of time to execute tasks with this scheduler (overrides the task control parameter maxTimesToRun).

Method Detail

initializeTaskTimes

protected void initializeTaskTimes()

initializes the task start and end times

schedule

protected boolean schedule(ClientRecord client,
                           long now,
                           ComplexTaskScheduler ts)

Schedules the client with the task, after rechecking under synchronization that the client is still available for scheduling. Returns true if the client was actually scheduled.

hasTask

protected boolean hasTask(ClientRecord client,
                          long now)

returns whether the client has an eligible task

selectTask

protected TestTask selectTask(ClientRecord client,
                              long now)

selects the best eligible task for the client to run

terminateScheduling

protected boolean terminateScheduling(int count,
                                      long now)

True if it is time to stop scheduling clients. Else if the scheduler is idle, prints a report then pauses to avoid running hot.

waitForDynamicThreadsToFinish

protected void waitForDynamicThreadsToFinish()

Blocks until all dynamic scheduler threads have completed. If they have not, prints a report then pauses to avoid running hot

exceededMaxResultWaitSec

protected boolean exceededMaxResultWaitSec(long now)

True if any clients are still busy and have run out of time.

Overrides:

exceededMaxResultWaitSec in class BaseTaskScheduler

receiveStopSchedulingOrder

protected void receiveStopSchedulingOrder()

Registers the fact that a StopSchedulingOrder has been thrown.

receivedStopSchedulingOrder

protected boolean receivedStopSchedulingOrder()

Returns true if a StopSchedulingOrder has been thrown.