desmoj.extensions.applicationDomains.harbour

Class C_Control

java.lang.Object

desmoj.core.simulator.NamedObject

desmoj.core.simulator.ModelComponent

desmoj.core.simulator.Schedulable

desmoj.core.simulator.Entity

desmoj.core.simulator.SimProcess

desmoj.extensions.applicationDomains.harbour.C_Control

public class C_Control
extends SimProcess

A C_Control represents the control component for the cranes. The cranes and the transporters (external/internal) can activate (interrupt) the crane control to begin with their serving. Its lifeCycle() is already implemented and spezifies the behavior of the crane control.

Version:

DESMO-J, Ver. 2.5.1c copyright (c) 2015

Author:

Eugenia Neufeld Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

See Also:

SimProcess, CranesSystem

Constructor Summary

Constructors

Constructor and Description
C_Control(Model owner, java.lang.String name, int cQSortOrder, int cQCapacity, int tQSortOrder, int tQCapacity, boolean showInReport, boolean showInTrace) Constructor for a crane control C_Control for the cranes.

Method Summary

Modifier and Type	Method and Description
void	CraneIsIdle() This method is used by a crane to send the message to this crane control that it is idle and waits on its serving.
CranesSystem	getCS() Returns the cranes system of this crane control.
void	lifeCycle() This method implements crane control specific behaviour.
void	serveCrane() This method implements the specific behaviour of the crane control if a crane is idle must be served by this control.
void	serveTransporter() This method implements the specific behaviour of the crane control if a transporter arrives and must be served by this control.
void	transporterArrival() This method is used by a transporter (external/internal) to send the message to this crane control that it arrives and waits on its serving.

Methods inherited from class desmoj.core.simulator.SimProcess

activate, activate, activate, activateAfter, activateBefore, activatePreempt, cancelInterruptDelayed, canCooperate, clearInterruptCode, cooperate, getActivatedBy, getInterruptCode, getInterruptException, getMaster, getRealTimeConstraint, getSchedulingPriority, getSlaveWaitQueue, getSupervisor, hold, hold, hold, interrupt, interrupt, interruptDelayed, interruptDelayed, isBlocked, isComponent, isDelayedInterruptScheduled, isInterrupted, isRepeating, isTerminated, obtainResources, passivate, prepareTransport, reActivate, reActivate, resetMaster, returnAllResources, returnResources, setBlocked, setRealTimeConstraint, setRepeating, setSchedulingPriority, setSlaveWaitQueue

Methods inherited from class desmoj.core.simulator.Entity

getIdentNumber, getQueueingPriority, getQueues, getScheduledEvents, isEqual, isLarger, isLargerOrEqual, isNotEqual, isQueued, isSimProcess, isSmaller, isSmallerOrEqual, schedule, schedule, schedule, schedule, schedule, schedule, schedule, schedule, schedule, scheduleAfter, scheduleAfter, scheduleAfter, scheduleBefore, scheduleBefore, scheduleBefore, schedulePreempt, schedulePreempt, schedulePreempt, setQueueingPriority

Methods inherited from class desmoj.core.simulator.Schedulable

assignReporter, cancel, getCorrespondingReportable, isCurrent, isScheduled, rename, reSchedule, reSchedule, reSchedulePreempt, scheduledNext, setCorrespondingReportable

Methods inherited from class desmoj.core.simulator.ModelComponent

current, currentEntity, currentEntityAll, currentEvent, currentModel, currentSimProcess, debugIsOn, debugOff, debugOn, getModel, isExperimentCompatible, isModelCompatible, presentTime, sendDebugNote, sendMessage, sendTraceNote, sendWarning, skipTraceNote, skipTraceNote, traceIsOn, traceOff, traceOn

Methods inherited from class desmoj.core.simulator.NamedObject

getName, getQuotedName, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

C_Control

public C_Control(Model owner,
                 java.lang.String name,
                 int cQSortOrder,
                 int cQCapacity,
                 int tQSortOrder,
                 int tQCapacity,
                 boolean showInReport,
                 boolean showInTrace)

Constructor for a crane control C_Control for the cranes. The queueing discipline and the capacity limit of the underlying queues for the cranes and for the transporters (external/internal) can be chosen.

Parameters:

owner - Model : The model this C_Control is associated to.

name - java.lang.String : The C_Control's name

csortOrder - int : determines the sort order of the underlying cranes queue implementation. Choose a constant from QueueBased like QueueBased.FIFO or QueueBased.LIFO or ...

cQCapacity - int : The capacity of the cranes queue, that is how many cranes can be enqueued. Zero (0) means unlimited capacity.

tsortOrder - int : determines the sort order of the underlying transporters queue implementation. Choose a constant from QueueBased like QueueBased.FIFO or QueueBased.LIFO or ...

tQCapacity - int : The capacity of the transporters queue, that is how many transporters can be enqueued. Zero (0) means unlimited capacity.

showInReport - boolean : Flag, if C_Control (its CranesSystem) should produce a report or not.

showInTrace - boolean : Flag for trace to produce trace messages.

Method Detail

getCS

public CranesSystem getCS()

Returns the cranes system of this crane control.

Returns:

CranesSystem: The crane system of this crane control.

transporterArrival

public void transporterArrival()
                        throws SuspendExecution

This method is used by a transporter (external/internal) to send the message to this crane control that it arrives and waits on its serving.

Throws:

SuspendExecution

CraneIsIdle

public void CraneIsIdle()
                 throws SuspendExecution

This method is used by a crane to send the message to this crane control that it is idle and waits on its serving.

Throws:

SuspendExecution

lifeCycle

public void lifeCycle()
               throws SuspendExecution

This method implements crane control specific behaviour. This behavior is always the same therefore there is no need to implement that in a subclass of C_Cotrol. This method starts after a crane contrl has been created and activated by the scheduler.

Specified by:

lifeCycle in class SimProcess

Throws:

SuspendExecution

serveTransporter

public void serveTransporter()

This method implements the specific behaviour of the crane control if a transporter arrives and must be served by this control. It's implemented for the case - a ship arrives and needs some cranes for his unloading and/or loading. Override this method to specify another case or behavior.

serveCrane

public void serveCrane()

This method implements the specific behaviour of the crane control if a crane is idle must be served by this control. It's implemented for the case - a crane is idle and the crane control tries to find a ship that waits for his serving and this crane can be assigned to. If the crane was assigned it checks if the ship is ready and can be acivated. Override this method to specify another case or behavior.