agentgui.simulationService

Interface LoadServiceHelper

All Superinterfaces:

jade.core.ServiceHelper

All Known Implementing Classes:

LoadService.LoadServiceImpl

public interface LoadServiceHelper
extends jade.core.ServiceHelper

Here, the accessible methods of the LoadService can be found.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	SERVICE_NAME The name of this service.

Method Summary

Modifier and Type	Method and Description
RemoteContainerConfig	getAutoRemoteContainerConfig() Provides the default remote container configuration.
ClientAvailableMachinesReply	getAvailableMachines() Gets the available machines.
double	getAvgCycleTime() Provides the average cycle time for a simulation.
LoadInformation.NodeDescription	getContainerDescription(java.lang.String containerName) Gets the NodeDescription of a specified container.
java.util.Hashtable<java.lang.String,LoadInformation.NodeDescription>	getContainerDescriptions() Gets the NodeDescription of all involved nodes.
PlatformLoad	getContainerLoad(java.lang.String containerName) Returns the load of a specified container.
java.util.Hashtable<java.lang.String,PlatformLoad>	getContainerLoadHash() Returns the load of all connected container.
jade.core.Location	getContainerLocation(java.lang.String containerName) Gets the container location of a specified container.
java.util.Hashtable<java.lang.String,jade.core.Location>	getContainerLocations() Provides the container locations of all connected container.
java.util.Vector<java.lang.String>	getContainerNames() Returns the list of all available container.
LoadAgentMap	getLoadAgentMap() Returns the current LoadAgentMap.
ClientRemoteContainerReply	getLocalCRCReply() Returns the locally saved ClientRemoteContainerReply.
void	putAvailableMachines(ClientAvailableMachinesReply availableMachines) Puts the available machines to the load information.
void	putContainerDescription(ClientRemoteContainerReply crcReply) Broadcasts a container description to all involved node, if the ClientRemoteContainerReply is valid.
void	requestAvailableMachines() Requests at the main container for the available machines.
void	requestThreadMeasurements(LoadMeasureAgent loadMeasureAgent) Requests all involved JVMs to do the thread measurements.
void	setAgentMigration(java.util.Vector<LoadAgentMap.AID_Container> transferAgents) Sets the agent migration.
void	setAndSaveCRCReplyLocal(ClientRemoteContainerReply crcReply) Sets and save the local ClientRemoteContainerReply.
void	setDefaults4RemoteContainerConfig(RemoteContainerConfig remoteContainerConfig) Sets the default remote container configuration.
void	setSimulationCycleStartTimeStamp() Sets System.currentTimeMillis() as an indicator for the start of an new simulations cycle.
void	setThresholdLevels(LoadThresholdLevels currThresholdLevels) Sets the threshold levels for all involved container.
boolean	startAgent(java.lang.String agentName, java.lang.String agentClassName, java.lang.Object[] args, java.lang.String containerName) Start an agent on a specified location.
java.lang.String	startNewRemoteContainer() Will start a new remote container.
java.lang.String	startNewRemoteContainer(RemoteContainerConfig remoteConfig) Will start a new remote container.
LoadInformation.Container2Wait4	startNewRemoteContainerStaus(java.lang.String containerName) Returns the current status of the requested new container.

Methods inherited from interface jade.core.ServiceHelper

init

Field Detail

SERVICE_NAME

static final java.lang.String SERVICE_NAME

The name of this service.

See Also:

Constant Field Values

Method Detail

startAgent

boolean startAgent(java.lang.String agentName,
                   java.lang.String agentClassName,
                   java.lang.Object[] args,
                   java.lang.String containerName)
            throws jade.core.ServiceException

Start an agent on a specified location.

Parameters:

agentName - the local name for the agent

agentClassName - the class of the agent

args - the serializable Object array for the start arguments

containerName - the name of the container, where the agent should start

Returns:

true, if successful

Throws:

jade.core.ServiceException - the service exception

startNewRemoteContainer

java.lang.String startNewRemoteContainer()
                                  throws jade.core.ServiceException

Will start a new remote container.

Returns:

the name of the new container

Throws:

jade.core.ServiceException - the service exception

startNewRemoteContainer

java.lang.String startNewRemoteContainer(RemoteContainerConfig remoteConfig)
                                  throws jade.core.ServiceException

Will start a new remote container.

Parameters:

remoteConfig - the remote container configuration

Returns:

the name of the new container

Throws:

jade.core.ServiceException - the service exception

getAutoRemoteContainerConfig

RemoteContainerConfig getAutoRemoteContainerConfig()
                                            throws jade.core.ServiceException

Provides the default remote container configuration.

Returns:

the default remote container configuration

Throws:

jade.core.ServiceException - the service exception

setDefaults4RemoteContainerConfig

void setDefaults4RemoteContainerConfig(RemoteContainerConfig remoteContainerConfig)
                                throws jade.core.ServiceException

Sets the default remote container configuration.

Parameters:

remoteContainerConfig - the new default remote container configuration

Throws:

jade.core.ServiceException - the service exception

startNewRemoteContainerStaus

LoadInformation.Container2Wait4 startNewRemoteContainerStaus(java.lang.String containerName)
                                                      throws jade.core.ServiceException

Returns the current status of the requested new container.

Parameters:

containerName - the new containers name

Returns:

current status of the requested new remote container

Throws:

jade.core.ServiceException - the service exception

See Also:

LoadInformation.Container2Wait4

getContainerNames

java.util.Vector<java.lang.String> getContainerNames()
                                              throws jade.core.ServiceException

Returns the list of all available container.

Returns:

the container queue

Throws:

jade.core.ServiceException - the service exception

getAvgCycleTime

double getAvgCycleTime()
                throws jade.core.ServiceException

Provides the average cycle time for a simulation.

Returns:

the average cycle time fo a simulation

Throws:

jade.core.ServiceException - the service exception

See Also:

setSimulationCycleStartTimeStamp()

setSimulationCycleStartTimeStamp

void setSimulationCycleStartTimeStamp()
                               throws jade.core.ServiceException

Sets System.currentTimeMillis() as an indicator for the start of an new simulations cycle.

Throws:

jade.core.ServiceException - the service exception

See Also:

getAvgCycleTime()

setThresholdLevels

void setThresholdLevels(LoadThresholdLevels currThresholdLevels)
                 throws jade.core.ServiceException

Sets the threshold levels for all involved container.

Parameters:

currThresholdLevels - the new threshold levels

Throws:

jade.core.ServiceException - the service exception

getContainerLoadHash

java.util.Hashtable<java.lang.String,PlatformLoad> getContainerLoadHash()
                                                                 throws jade.core.ServiceException

Returns the load of all connected container.

Returns:

the container loads

Throws:

jade.core.ServiceException - the service exception

getContainerLoad

PlatformLoad getContainerLoad(java.lang.String containerName)
                       throws jade.core.ServiceException

Returns the load of a specified container.

Parameters:

containerName - the container name

Returns:

the container load

Throws:

jade.core.ServiceException - the service exception

getContainerLocations

java.util.Hashtable<java.lang.String,jade.core.Location> getContainerLocations()
                                                                        throws jade.core.ServiceException

Provides the container locations of all connected container.

Returns:

the container locations

Throws:

jade.core.ServiceException - the service exception

getContainerLocation

jade.core.Location getContainerLocation(java.lang.String containerName)
                                 throws jade.core.ServiceException

Gets the container location of a specified container.

Parameters:

containerName - the container name

Returns:

the container location

Throws:

jade.core.ServiceException - the service exception

setAndSaveCRCReplyLocal

void setAndSaveCRCReplyLocal(ClientRemoteContainerReply crcReply)
                      throws jade.core.ServiceException

Sets and save the local ClientRemoteContainerReply.

Parameters:

crcReply - the ClientRemoteContainerReply to save

Throws:

jade.core.ServiceException - the service exception

getLocalCRCReply

ClientRemoteContainerReply getLocalCRCReply()
                                     throws jade.core.ServiceException

Returns the locally saved ClientRemoteContainerReply.

Returns:

the local ClientRemoteContainerReply

Throws:

jade.core.ServiceException - the service exception

putContainerDescription

void putContainerDescription(ClientRemoteContainerReply crcReply)
                      throws jade.core.ServiceException

Broadcasts a container description to all involved node, if the ClientRemoteContainerReply is valid.

Parameters:

crcReply - the crc reply

Throws:

jade.core.ServiceException - the service exception

getContainerDescriptions

java.util.Hashtable<java.lang.String,LoadInformation.NodeDescription> getContainerDescriptions()
                                                                                        throws jade.core.ServiceException

Gets the NodeDescription of all involved nodes.

Returns:

the container descriptions

Throws:

jade.core.ServiceException - the service exception

See Also:

LoadInformation.NodeDescription

getContainerDescription

LoadInformation.NodeDescription getContainerDescription(java.lang.String containerName)
                                                 throws jade.core.ServiceException

Gets the NodeDescription of a specified container.

Parameters:

containerName - the container name

Returns:

the container description

Throws:

jade.core.ServiceException - the service exception

See Also:

LoadInformation.NodeDescription

getLoadAgentMap

LoadAgentMap getLoadAgentMap()
                      throws jade.core.ServiceException

Returns the current LoadAgentMap.

Returns:

the current LoadAgentMap

Throws:

jade.core.ServiceException - the service exception

See Also:

LoadAgentMap

setAgentMigration

void setAgentMigration(java.util.Vector<LoadAgentMap.AID_Container> transferAgents)
                throws jade.core.ServiceException

Sets the agent migration.

Parameters:

transferAgents - the agents, which has to be migrated

Throws:

jade.core.ServiceException - the service exception

requestThreadMeasurements

void requestThreadMeasurements(LoadMeasureAgent loadMeasureAgent)
                        throws jade.core.ServiceException

Requests all involved JVMs to do the thread measurements.

Parameters:

loadMeasureAgent - the load measure agent

Throws:

jade.core.ServiceException - the service exception

requestAvailableMachines

void requestAvailableMachines()
                       throws jade.core.ServiceException

Requests at the main container for the available machines.

Throws:

jade.core.ServiceException - the service exception

putAvailableMachines

void putAvailableMachines(ClientAvailableMachinesReply availableMachines)
                   throws jade.core.ServiceException

Puts the available machines to the load information.

Parameters:

availableMachines - the available machines

Throws:

jade.core.ServiceException - the service exception

getAvailableMachines

ClientAvailableMachinesReply getAvailableMachines()
                                           throws jade.core.ServiceException

Gets the available machines.

Returns:

the available machines

Throws:

jade.core.ServiceException - the service exception