Interface AcquireAction
- All Superinterfaces:
AbstractAction
,AbstractInternalControlFlowAction
,org.eclipse.emf.cdo.CDOObject
,org.eclipse.emf.cdo.common.id.CDOWithID
,Entity
,EObject
,de.uka.ipd.sdq.identifier.Identifier
,NamedElement
,Notifier
,PCMBaseClass
,PCMClass
- All Known Implementing Classes:
AcquireActionImpl
In an RDSEFF, component developers can specify an AcquireAction, which references a passive resource types. Once analysis tools execute this action, they decrease the amount of items available from the referenced passive resource type by one, if at least one item is available. If none item is available, because other, concurrently executed requests have acquired all of them, analysis tools enqueue the current request (first-come-first-serve scheduling policy) and block it's further execution.
Acquisition and release of passive resources happen instantaneously and do not consume any time except for waiting delays before actual acquisition. Resource locking may introduce deadlocks when simulating the model, however, for performance analysis with the PCM it is assumed that no deadlocks occur. Otherwise, the model first needs to be fixed accordingly before carrying out the performance prediction.
A reliability-related extension is the timeout mechanism that may be associated to an AcquireAction through the "timeout" and "timeoutValue" attributes. See the documentation of the "timeout" attribute for further information.
The following features are supported:
- See Also:
- Generated class or method.
- EMF model class or method.
- annotation="http://www.eclipse.org/emf/2002/Ecore constraints='timeoutValueOfAcquireActionMustNotBeNegative'" annotation="http://www.eclipse.org/emf/2002/Ecore/OCL/LPG timeoutValueOfAcquireActionMustNotBeNegative='self.timeoutValue.oclAsType(Real) >= 0.0'"
-
Field Summary
-
Method Summary
Modifier and TypeMethodDescriptionReturns the value of the 'Passiveresource Acquire Action' reference.double
Returns the value of the 'Timeout Value' attribute.boolean
Returns the value of the 'Timeout' attribute.void
Sets the value of the 'Passiveresource Acquire Action
' reference.void
setTimeout
(boolean value) Sets the value of the 'Timeout
' attribute.void
setTimeoutValue
(double value) Sets the value of the 'Timeout Value
' attribute.Methods inherited from interface org.palladiosimulator.pcm.seff.AbstractAction
getPredecessor_AbstractAction, getResourceDemandingBehaviour_AbstractAction, getSuccessor_AbstractAction, setPredecessor_AbstractAction, setResourceDemandingBehaviour_AbstractAction, setSuccessor_AbstractAction
Methods inherited from interface org.palladiosimulator.pcm.seff.AbstractInternalControlFlowAction
getInfrastructureCall__Action, getResourceCall__Action, getResourceDemand_Action
Methods inherited from interface org.eclipse.emf.cdo.CDOObject
cdoConflict, cdoDirectResource, cdoHistory, cdoID, cdoInvalid, cdoLockState, cdoPermission, cdoPrefetch, cdoReadLock, cdoReload, cdoResource, cdoRevision, cdoRevision, cdoState, cdoView, cdoWriteLock, cdoWriteOption
Methods inherited from interface org.eclipse.emf.ecore.EObject
eAllContents, eClass, eContainer, eContainingFeature, eContainmentFeature, eContents, eCrossReferences, eGet, eGet, eInvoke, eIsProxy, eIsSet, eResource, eSet, eUnset
Methods inherited from interface de.uka.ipd.sdq.identifier.Identifier
getId, setId
Methods inherited from interface org.palladiosimulator.pcm.core.entity.NamedElement
getEntityName, setEntityName
Methods inherited from interface org.eclipse.emf.common.notify.Notifier
eAdapters, eDeliver, eNotify, eSetDeliver
-
Field Details
-
copyright
- See Also:
- Generated class or method.
-
-
Method Details
-
getPassiveresource_AcquireAction
PassiveResource getPassiveresource_AcquireAction()Returns the value of the 'Passiveresource Acquire Action' reference.- Returns:
- the value of the 'Passiveresource Acquire Action' reference.
- See Also:
- Generated class or method.
- EMF model class or method.
- required="true" ordered="false"
-
setPassiveresource_AcquireAction
Sets the value of the 'Passiveresource Acquire Action
' reference.- Parameters:
value
- the new value of the 'Passiveresource Acquire Action' reference.- See Also:
- Generated class or method.
-
isTimeout
boolean isTimeout()Returns the value of the 'Timeout' attribute.Indicates if the AcquireAction has a timeout. If yes, a simulation through SimuCom with the "simulate failures" option switched on will consider the timeout as follows: Any acquiring thread waits no longer than the duration specified in "timeoutValue". If the maximum waiting time is reached, the thread is removed from the waiting queue and cancelled by a timeout failure.
The reliability Markov analysis does not consider AcquireAction timeouts.
As any failure-on-demand occurrence, timeout failures can be handled by "RecoveryBlockActions" at any higher level in the caller hierarchy. To achieve this, the modeller must specify a "ResourceTimeoutFailureType" pointing to the "PassiveResource" that the AcquireAction is related to. The specified "ResourceTimeoutFailureType" can then be added to the list of handled failure types of any "RecoveryBlockAlternativeBehaviour".
Please notice the following limitation of the current implementation of timeout handling: Timeouts are only considered by SimuCom if the executing software component is allocated to a resource container with an operating system set to "ABSTRACT" (i.e. no specific OS schedulers are supported). The timeout handling implementation can be found in de.uka.ipd.sdq.simucomframework.resources.SimSimpleFairPassiveResource.
- Returns:
- the value of the 'Timeout' attribute.
- See Also:
- Generated class or method.
- EMF model class or method.
- required="true" ordered="false"
-
setTimeout
void setTimeout(boolean value) Sets the value of the 'Timeout
' attribute.- Parameters:
value
- the new value of the 'Timeout' attribute.- See Also:
- Generated class or method.
-
getTimeoutValue
double getTimeoutValue()Returns the value of the 'Timeout Value' attribute.Specifies a timeout value, in case the AcquireAction has a timeout (see the documentation of the "timeout" attribute for further information).
- Returns:
- the value of the 'Timeout Value' attribute.
- See Also:
- Generated class or method.
- EMF model class or method.
- required="true" ordered="false"
-
setTimeoutValue
void setTimeoutValue(double value) Sets the value of the 'Timeout Value
' attribute.- Parameters:
value
- the new value of the 'Timeout Value' attribute.- See Also:
- Generated class or method.
-