org.javades.jqueues.r5.extensions.qos

Class SimQueuePredictor_PQ<J extends SimJob,Q extends PQ,P extends Comparable>

java.lang.Object

org.javades.jqueues.r5.util.predictor.AbstractSimQueuePredictor<Q>

org.javades.jqueues.r5.util.predictor.queues.SimQueuePredictor_Preemptive<Q>

org.javades.jqueues.r5.extensions.qos.SimQueuePredictor_PQ<J,Q,P>

Type Parameters:

J - The type of SimJobs supported.

Q - The type of SimQueues supported.

P - The type used for QoS.

All Implemented Interfaces:

SimQueueEventPredictor<Q>, SimQueuePredictor<Q>, SimQueueStatePredictor<Q>

public class SimQueuePredictor_PQ<J extends SimJob,Q extends PQ,P extends Comparable>
extends SimQueuePredictor_Preemptive<Q>

A SimQueuePredictor for PQ.

Author:

Jan de Jongh, TNO

Copyright (C) 2005-2017 Jan de Jongh, TNO

This file is covered by the LICENSE file in the root of this project.

Constructor Summary

Constructors

Constructor and Description
SimQueuePredictor_PQ()

Method Summary

Modifier and Type	Method and Description
SimQueueState<SimJob,Q>	createQueueState(Q queue, boolean isROEL) Registers a new SimQueueQoSStateHandler at the object created by super method.
void	doQueueEvents_SQ_SV_ROEL_U(Q queue, SimQueueState<SimJob,Q> queueState, Set<SimEntitySimpleEventType.Member> queueEventTypes, Set<JobQueueVisitLog<SimJob,Q>> visitLogsSet) Process the next event(s) at a queue with given state.
void	doWorkloadEvents_SQ_SV_ROEL_U(Q queue, WorkloadSchedule_SQ_SV_ROEL_U workloadSchedule, SimQueueState<SimJob,Q> queueState, Set<SimEntitySimpleEventType.Member> workloadEventTypes, Set<JobQueueVisitLog<SimJob,Q>> visitLogsSet) Process the next event(s) from given WorkloadSchedule at a queue with given state.
protected J	getJobExecuting(Q queue, SimQueueState<SimJob,Q> queueState)
protected J	getJobToExecute(Q queue, SimQueueState<SimJob,Q> queueState)
double	getNextQueueEventTimeBeyond(Q queue, SimQueueState<SimJob,Q> queueState, Set<SimEntitySimpleEventType.Member> queueEventTypes) Returns the time and types of the next event(s) scheduled strictly beyond the time at (the state object of) a specific queue.
boolean	isStartArmed(Q queue, SimQueueState<SimJob,Q> queueState) Checks whether a given state represents StartArmed on given queue.
protected void	reschedule(Q queue, SimQueueState<SimJob,Q> queueState, Set<JobQueueVisitLog<SimJob,Q>> visitLogsSet)
String	toString()
void	updateToTime(Q queue, SimQueueState queueState, double newTime) Updates the queue state to a new time, without processing any events.

Methods inherited from class org.javades.jqueues.r5.util.predictor.queues.SimQueuePredictor_Preemptive

preemptJob

Methods inherited from class org.javades.jqueues.r5.util.predictor.AbstractSimQueuePredictor

is_ROEL_U_UnderWorkloadQueueEventClashes, is_U_UnderWorkloadQueueEventClashes, predict_SQ_SV_IOEL_U, predict_SQ_SV_ROEL_U

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.javades.jqueues.r5.util.predictor.SimQueuePredictor

matchVisitLogs_SQ_SV

Methods inherited from interface org.javades.jqueues.r5.util.predictor.SimQueueEventPredictor

createWorkloadSchedule_SQ_SV_ROEL_U, createWorkloadSchedule_SQ_SV, doWorkloadEvents_SQ_SV

Methods inherited from interface org.javades.jqueues.r5.util.predictor.SimQueueStatePredictor

hasServerAccessCredits, isQueueAccessVacation

Constructor Detail

SimQueuePredictor_PQ

public SimQueuePredictor_PQ()

Method Detail

toString

public String toString()

Overrides:

toString in class Object

isStartArmed

public boolean isStartArmed(Q queue,
                            SimQueueState<SimJob,Q> queueState)

Description copied from interface: SimQueueStatePredictor

Checks whether a given state represents StartArmed on given queue.

Parameters:

queue - The queue.

queueState - The queue state, non-null.

Returns:

True if the state represents StartArmed at given queue.

createQueueState

public SimQueueState<SimJob,Q> createQueueState(Q queue,
                                                boolean isROEL)

Registers a new SimQueueQoSStateHandler at the object created by super method.

Parameters:

queue - The queue, non-null.

isROEL - Whether or not the event list used is a Random-Order Event List.

Returns:

The object created by the super method with a new registered SimQueueQoSStateHandler.

getJobToExecute

protected J getJobToExecute(Q queue,
                            SimQueueState<SimJob,Q> queueState)

getJobExecuting

protected J getJobExecuting(Q queue,
                            SimQueueState<SimJob,Q> queueState)

reschedule

protected void reschedule(Q queue,
                          SimQueueState<SimJob,Q> queueState,
                          Set<JobQueueVisitLog<SimJob,Q>> visitLogsSet)
                   throws SimQueuePredictionException

Throws:

SimQueuePredictionException

getNextQueueEventTimeBeyond

public double getNextQueueEventTimeBeyond(Q queue,
                                          SimQueueState<SimJob,Q> queueState,
                                          Set<SimEntitySimpleEventType.Member> queueEventTypes)

Description copied from interface: SimQueueEventPredictor

Returns the time and types of the next event(s) scheduled strictly beyond the time at (the state object of) a specific queue.

The time from which to search must be taken from SimQueueState.getTime(), and equals Double.NaN after initialization.

Parameters:

queue - The queue, non-null.

queueState - The queue-state, non-null.

queueEventTypes - A non-null set to store the (possible multiple) event types; it must be cleared upon entry.

Returns:

The time of the next event, or Double.NaN if no such event exists.

See Also:

SimJQSimpleEventType.START, SimJQSimpleEventType.DEPARTURE

doWorkloadEvents_SQ_SV_ROEL_U

public void doWorkloadEvents_SQ_SV_ROEL_U(Q queue,
                                          WorkloadSchedule_SQ_SV_ROEL_U workloadSchedule,
                                          SimQueueState<SimJob,Q> queueState,
                                          Set<SimEntitySimpleEventType.Member> workloadEventTypes,
                                          Set<JobQueueVisitLog<SimJob,Q>> visitLogsSet)
                                   throws SimQueuePredictionException,
                                          WorkloadScheduleException

Description copied from interface: SimQueueEventPredictor

Process the next event(s) from given WorkloadSchedule at a queue with given state.

The scheduled time and the types of the next events must be known beforehand, e.g., through WorkloadSchedule.getNextEventTimeBeyond(org.javades.jqueues.r5.entity.jq.queue.SimQueue, double, java.util.Set<org.javades.jqueues.r5.entity.SimEntitySimpleEventType.Member>). The scheduled time has already been set on the SimQueueState object, and the object has been updated upto that time. The time on the queue state must not be changed.

Implementations must update the queue state and (if applicable) add suitable entries to the visit logs.

Implementations must not modify the workload schedule.

Parameters:

queue - The queue, non-null.

workloadSchedule - The workload schedule, non-null.

queueState - The queue-state, non-null.

workloadEventTypes - The (pre-calculated) types of the next workload event(s).

visitLogsSet - The visit logs, non-null.

Throws:

SimQueuePredictionException - If the result cannot be computed, e.g., due to invalid input or schedule ambiguities.

WorkloadScheduleException - If the workload is invalid (e.g., containing ambiguities).

See Also:

WorkloadSchedule.getNextEventTimeBeyond(org.javades.jqueues.r5.entity.jq.queue.SimQueue, double, java.util.Set<org.javades.jqueues.r5.entity.SimEntitySimpleEventType.Member>), SimQueueEventPredictor.updateToTime(Q, org.javades.jqueues.r5.util.predictor.state.SimQueueState, double), SimQueueState.setTime(double)

doQueueEvents_SQ_SV_ROEL_U

public void doQueueEvents_SQ_SV_ROEL_U(Q queue,
                                       SimQueueState<SimJob,Q> queueState,
                                       Set<SimEntitySimpleEventType.Member> queueEventTypes,
                                       Set<JobQueueVisitLog<SimJob,Q>> visitLogsSet)
                                throws SimQueuePredictionException

Description copied from interface: SimQueueEventPredictor

Process the next event(s) at a queue with given state.

The scheduled time and the types of the next events must be known beforehand, e.g., through SimQueueEventPredictor.getNextQueueEventTimeBeyond(Q, org.javades.jqueues.r5.util.predictor.state.SimQueueState<org.javades.jqueues.r5.entity.jq.job.SimJob, Q>, java.util.Set<org.javades.jqueues.r5.entity.SimEntitySimpleEventType.Member>). The scheduled time has already been set on the SimQueueState object, and the object has been updated upto that time. The time on the queue state must not be changed.

Implementations must update the queue state and (if applicable) add suitable entries to the visit logs.

Parameters:

queue - The queue, non-null.

queueState - The queue-state, non-null

queueEventTypes - The (pre-calculated) types of the next workload event(s).

visitLogsSet - The visit logs, non-null.

Throws:

SimQueuePredictionException - If the result cannot be computed, e.g., due to invalid input or schedule ambiguities.

See Also:

SimQueueEventPredictor.getNextQueueEventTimeBeyond(Q, org.javades.jqueues.r5.util.predictor.state.SimQueueState<org.javades.jqueues.r5.entity.jq.job.SimJob, Q>, java.util.Set<org.javades.jqueues.r5.entity.SimEntitySimpleEventType.Member>), SimQueueEventPredictor.updateToTime(Q, org.javades.jqueues.r5.util.predictor.state.SimQueueState, double), SimQueueState.setTime(double)

updateToTime

public void updateToTime(Q queue,
                         SimQueueState queueState,
                         double newTime)

Description copied from interface: SimQueueEventPredictor

Updates the queue state to a new time, without processing any events.

Implementations must at least set the time on the queue state. Beware that the old time on the queue state may equal its initial value Double.NaN.

Parameters:

queue - The queue, non-null.

queueState - The queue-state, non-null.

newTime - The new time.

See Also:

SimQueueState.setTime(double)