oracle.ifs.core.beans

Class ControllerPlanExecution

java.lang.Object

oracle.ifs.beans.LibraryObject

oracle.ifs.beans.TieLibraryObject

oracle.ifs.beans.SimpleObject

oracle.ifs.beans.TieSimpleObject

oracle.ifs.core.beans.ControllerPlanExecution

All Implemented Interfaces:

Comparable, IfsEventHandler, LibraryObjectInterface, LooselyBoundedCacheable, SimpleObjectInterface, Traceable

Direct Known Subclasses:

TieControllerPlanExecution

public class ControllerPlanExecution
extends TieSimpleObject

A ControllerPlanExecution is used by the Controller to manage the execution of the ControllerPlan.

Author:

Dave Long

Field Summary

Fields

Modifier and Type	Field and Description
static String	ACTIVE_ATTRIBUTE The name of the Attribute representing An indicator of whether this ControllerJob is still being worked on by the Controller.
static String	ASSIGNEDNODES_ATTRIBUTE The name of the Attribute representing the Nodes assigned for execution that matches the Node types indicated in the associated plan.
static String	CLASS_NAME The name of the ClassObject representing this class.
static String	CONTROLLERPLAN_ATTRIBUTE The name of the Attribute representing Reference to the ControllerPlan being executed.
static String	EXECUTIONDATE_ATTRIBUTE The name of the Attribute representing The date this ControllerPlanExecution was started.
static String	EXECUTIONPLANTABLELIST_ATTRIBUTE The name of the Attribute representing Reference to object holding the details describing the execution plan.
static String	FULLYSTARTED_ATTRIBUTE The name of the Attribute representing An indicator of whether this plan execution has reached a fully started state, meaning that runnables are assigned to the most appropriate Node.
static String	NODECOUNT_ATTRIBUTE The name of the Attribute representing The number of Nodes expected according to the associated plan.
static String	UUID_ATTRIBUTE The name of the Attribute representing the UUID.

Fields inherited from class oracle.ifs.beans.LibraryObject

DOMAIN_UNIQUENAME_DEFAULT_DELIMITER, m_ClassId, m_Id, m_Session, NAME_ATTRIBUTE, PROPERTYBUNDLE_ATTRIBUTE

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ControllerPlanExecution(LibrarySession session, Long id, Long classId, S_LibraryObjectData data) Construct a ControllerPlanExecution object.

Method Summary

Modifier and Type	Method and Description
void	addRunningNodeState(NodeState newNode) Add a new NodeState to the set of available NodeStates managed by this instance.
void	clearRecoveryBeginDate() Clears the recovery begin Date.
void	clearStartupBeginDate() Clears the startup begin Date.
static ControllerPlanExecution	create(ControllerPlan cplan) Create a simple ControllerPlanExecution from a ControllerPlan.
HandlerState	createAssignedHandlerState(AuditSpecification spec) Get an available NodeState to assign for the specified Handler.
ServerState	createAssignedServerState(ServerSpecification spec) Get an available NodeState to assign for the specified ServerSpecification and if found, create a ServerState the Controller can request to start new.
NodeState[]	getAssignedNodes() Gets the Nodes assigned for execution that matches the Node types indicated in the associated plan.
List<AttributeValueTable>	getAssignments() Gets the set of assignment definitions for this plan execution.
ControllerPlan	getControllerPlan() Gets Reference to the ControllerPlan being executed.
static ControllerPlanExecution	getCurrent(LibrarySession session) Gets the currently executing ControllerPlanExecution.
Date	getExecutionDate() Gets The date this ControllerPlanExecution was started.
SimplePropertyTableList	getExecutionPlanTableList() Gets Reference to object holding the details describing the plan execution.
int	getNodeCount() Gets the number of Nodes expected according to the associated plan.
SimplePropertyTable	getObjectPropertyTable() Gets the SimplePropertyTable representing this object's metadata.
Date	getRecoveryBeginDate() Gets the recovery begin Date, the time/date at which recovery towards becoming fully started begins.
String	getRecoveryPeriod() Gets the recovery time period, which is the duration to wait before returning back to a "fully started" state after one or more assigned Nodes are no longer assigned.
long	getRecoveryPeriodDuration() Gets the recovery time period duration.
Date	getStartupBeginDate() Gets the startup begin Date, the time/date at which starting up towards becoming fully started begins.
String	getStartupPeriod() Gets the startup time period, which is the duration to wait while assigning Nodes before automatically changing to a "fully started" state.
long	getStartupPeriodDuration() Gets the startup time period duration.
String	getUuid() Gets the value of the UUID attribute.
boolean	hasUnassignedNodes() Gets whether there are any unassigned Nodes in the current set of assigned nodes.
boolean	isActive() Gets an indicator of whether this ControllerJob is still being worked on by the Controller.
boolean	isAssignedNode(NodeState ns) Gets whether the specified NodeState is one of the assigned nodes.
boolean	isEveryAssignmentFinal() Gets an indicator of whether every assignment entry should be considered as being defined as "final", meaning the classification hierarchy will not be checked further if no Node is defined at the lowest defined level.
boolean	isFullyStarted() Gets an indicator of whether this plan execution has reached a fully started state, meaning that runnables are assigned to the most appropriate Node.
boolean	isNormalControllerRelease() Gets an indicator of whether the Controller was released normally.
boolean	isRecalculationNeeded() Gets an indicator of whether recalculation of assignemnt counts is needed.
boolean	isShorthanded() Gets an indicator of whether we were shorthanded when going into "Fully Started" mode, indicating that a rebalnce operation will be required once all Nodes ae restarted.
boolean	isShutdownInProgress() Gets an indicator of whether a shutdown is in progress.
void	performTimedDuties() Perform timed duties.
protected void	recalculateAssignmentCounts() Recaclulate the counts for all Assignments.
protected void	recalculateAssignmentCountsIfNeeded() Recalculate the counts for all Assignments, if a property indicates that a reclaculation is needed prior to assigning any server/handler.
boolean	recoveryPeriodElapsed() See if the recovery period has elapsed.
void	setActive(boolean active) Sets the ACTIVE attribute for this object.
void	setAssignedNodes(NodeState[] nodeStates) Sets the Nodes assigned for execution that matches the Node types indicated in the associated plan.
void	setEveryAssignmentFinal(boolean val) Sets an indicator of whether every assignment entry should be considered as being defined as "final", meaning the classification hierarchy will not be checked further if no Node is defined at the lowest defined level.
void	setFullyStarted(boolean started) Sets an indicator of whether this plan execution has reached a fully started state, meaning that runnables are assigned to the most appropriate Node.
void	setNormalControllerRelease(boolean val) Sets an indicator of whether the Controller was released normally.
void	setRecalculationNeeded(boolean val) Sets an indicator of whether recalculation of assignemnt counts is needed.
void	setRecoveryBeginDate() Sets the recovery begin Date to the current time/date.
void	setRecoveryBeginDate(Date val) Sets the recovery begin Date to the specified value.
void	setRecoveryPeriod(String val) Sets the recovery time period, which is the duration to wait before returning back to a "fully started" state after one or more assigned Nodes are no longer assigned.
void	setShorthanded(boolean val) Sets an indicator of whether we were shorthanded when going into "Fully Started" mode, indicating that a rebalnce operation will be required once all Nodes ae restarted.
void	setShutdownInProgress(boolean val) Sets an indicator of whether a shutdown is in progress.
void	setStartupBeginDate() Sets the startup begin Date to the current time/date.
void	setStartupBeginDate(Date val) Sets the startup begin Date to the specified value.
void	setStartupPeriod(String val) Sets the startup time period, which is the duration to wait while assigning Nodes before automatically changing to a "fully started" state.
boolean	startupPeriodElapsed() See if the startup period has elapsed.

Methods inherited from class oracle.ifs.beans.SimpleObject

free, handleCreate, isValidEventType

Methods inherited from class oracle.ifs.beans.LibraryObject

added, addSimpleProperty, addSimpleProperty, applyProperties, auditCreated, auditUpdated, canPurge, checkIfPropertyBundleSupported, checkRequiredAttributeSet, clearCopyContext, clearFreeContext, clearUpdateContext, compareTo, constructIdArray, constructIdArray, constructLibraryObject, constructLibraryObjectVector, createDedicatedPropertyBundle, createInstance, deriveDomainUniqueName, dispose, equals, equals, free, freeAll, get, getAttribute, getAttributeByUpperCaseName, getAttributes, getAttributesByUpperCaseNames, getAuditDomainContext, getAuditEventFolderContext, getClassId, getClassname, getClassName, getClassObject, getCommonName, getCommonNameAndClass, getCopyContext, getCreateContext, getData, getDefinition, getDefinitionForSimplePropertyUpdates, getEffectivePolicyListElements, getEventualAttributeByUpperCaseName, getFreeContext, getId, getLabel, getName, getObjectReferenceAttribute, getOperationActionSpecificationContext, getPropertyBundle, getPropertyValue, getPublicObjectAttribute, getResourceString, getResourceString, getSchemaObjectAttribute, getSession, getSessionInterface, getSharedStateFactory, getSimpleObjectAttribute, getSimpleProperties, getSimpleProperty, getSimplePropertyValue, getStringIdentifier, getSystemObjectAttribute, getTraceLogger, getUpdateContext, handleAdminModeChange, handleEvent, handleFree, handleUpdate, hashCode, hasNameAttribute, hasPropertyBundleAttribute, invalidateState, invokeOperation, invokeOperation, invokeServerMethod, isConnected, isCoreEventPostingEnabled, isInstanceOf, isPersistent, isTraced, lockRows, lookupInstanceLabel, performPostCreateExtensions, performPostFreeExtensions, performPostUpdateExtensions, performPreCreateExtensions, performPreFreeExtensions, performPreUpdateExtensions, postCreate, postEvent, postEvent, postFree, postUpdate, preCreate, preFree, prePostAuditEvent, preUpdate, putProperty, putProperty, removeAllProperties, removeAllSimpleProperties, removeAllSimpleProperties, removed, removeProperty, removeSimpleProperty, removeSimpleProperty, renderAsRandomAccessContent, renderAsReader, renderAsStream, setAttribute, setAttribute, setAttributes, setAttributes, setCopyContext, setFreeContext, setId, setName, setPropertyBundle, setPropertyValue, setUpdateContext, toString, trace, trustHandleCreate, trustHandleCreateAsAdmin, trustHandleFree, trustHandleFreeAsAdmin, trustHandleUpdate, trustHandleUpdateAsAdmin, update, updateAndExposeDefinition, validatePropertyValues, vectorLibraryObjectElement, vectorToLibraryObjectArray, verifyAdministrationMode, verifyConnected, verifyPersistent, verifySystemUserAccess, verifyTargetObject

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface oracle.ifs.common.LibraryObjectInterface

getAttributeByUpperCaseName, getClassId, getId, getSessionInterface

Methods inherited from interface oracle.ifs.common.Traceable

getTraceLogger, isTraced, trace

Field Detail

CLASS_NAME

public static final String CLASS_NAME

The name of the ClassObject representing this class.

See Also:

Constant Field Values

UUID_ATTRIBUTE

public static final String UUID_ATTRIBUTE

The name of the Attribute representing the UUID.

See Also:

Constant Field Values

CONTROLLERPLAN_ATTRIBUTE

public static final String CONTROLLERPLAN_ATTRIBUTE

The name of the Attribute representing Reference to the ControllerPlan being executed.

See Also:

Constant Field Values

EXECUTIONDATE_ATTRIBUTE

public static final String EXECUTIONDATE_ATTRIBUTE

The name of the Attribute representing The date this ControllerPlanExecution was started.

See Also:

Constant Field Values

ACTIVE_ATTRIBUTE

public static final String ACTIVE_ATTRIBUTE

The name of the Attribute representing An indicator of whether this ControllerJob is still being worked on by the Controller.

See Also:

Constant Field Values

FULLYSTARTED_ATTRIBUTE

public static final String FULLYSTARTED_ATTRIBUTE

The name of the Attribute representing An indicator of whether this plan execution has reached a fully started state, meaning that runnables are assigned to the most appropriate Node.

See Also:

Constant Field Values

NODECOUNT_ATTRIBUTE

public static final String NODECOUNT_ATTRIBUTE

The name of the Attribute representing The number of Nodes expected according to the associated plan.

See Also:

Constant Field Values

ASSIGNEDNODES_ATTRIBUTE

public static final String ASSIGNEDNODES_ATTRIBUTE

The name of the Attribute representing the Nodes assigned for execution that matches the Node types indicated in the associated plan.

See Also:

Constant Field Values

EXECUTIONPLANTABLELIST_ATTRIBUTE

public static final String EXECUTIONPLANTABLELIST_ATTRIBUTE

The name of the Attribute representing Reference to object holding the details describing the execution plan.

See Also:

Constant Field Values

Constructor Detail

ControllerPlanExecution

protected ControllerPlanExecution(LibrarySession session,
                                  Long id,
                                  Long classId,
                                  S_LibraryObjectData data)
                           throws IfsException

Construct a ControllerPlanExecution object.

Parameters:

session - current LibrarySession

id - object id

classId - class id

data - data component

Throws:

IfsException - if the operation fails

Method Detail

create

public static ControllerPlanExecution create(ControllerPlan cplan)
                                      throws IfsException

Create a simple ControllerPlanExecution from a ControllerPlan.

Parameters:

cplan - the ControllerPlan

Returns:

the newly created ControllerPlanExecution

Throws:

IfsException - if the operation fails

(Published)

recalculateAssignmentCounts

protected void recalculateAssignmentCounts()
                                    throws IfsException

Recaclulate the counts for all Assignments.

Throws:

IfsException - if the operation fails

recalculateAssignmentCountsIfNeeded

protected void recalculateAssignmentCountsIfNeeded()
                                            throws IfsException

Recalculate the counts for all Assignments, if a property indicates that a reclaculation is needed prior to assigning any server/handler.

Throws:

IfsException - if the operation fails

getCurrent

public static ControllerPlanExecution getCurrent(LibrarySession session)
                                          throws IfsException

Gets the currently executing ControllerPlanExecution.

Parameters:

session - the session context

Returns:

the currently executing ControllerPlanExecution

Throws:

IfsException - if the operation fails

getUuid

public String getUuid()
               throws IfsException

Gets the value of the UUID attribute.

Returns:

the attribute's value

Throws:

IfsException - if the operation fails

getControllerPlan

public ControllerPlan getControllerPlan()
                                 throws IfsException

Gets Reference to the ControllerPlan being executed.

Returns:

the attribute's value

Throws:

IfsException - if the operation fails

getExecutionDate

public Date getExecutionDate()
                      throws IfsException

Gets The date this ControllerPlanExecution was started.

Returns:

the attribute's value

Throws:

IfsException - if the operation fails

isActive

public boolean isActive()
                 throws IfsException

Gets an indicator of whether this ControllerJob is still being worked on by the Controller.

Returns:

the attribute's value

Throws:

IfsException - if the operation fails

isFullyStarted

public boolean isFullyStarted()
                       throws IfsException

Gets an indicator of whether this plan execution has reached a fully started state, meaning that runnables are assigned to the most appropriate Node.

Returns:

the attribute's value

Throws:

IfsException - if the operation fails

getNodeCount

public int getNodeCount()
                 throws IfsException

Gets the number of Nodes expected according to the associated plan.

Returns:

the attribute's value

Throws:

IfsException - if the operation fails

getAssignedNodes

public NodeState[] getAssignedNodes()
                             throws IfsException

Gets the Nodes assigned for execution that matches the Node types indicated in the associated plan.

Returns:

the attribute's value

Throws:

IfsException - if the operation fails

isAssignedNode

public boolean isAssignedNode(NodeState ns)
                       throws IfsException

Gets whether the specified NodeState is one of the assigned nodes.

Parameters:

ns - the NodeState to check

Returns:

true if the specified NodeState is assigned

Throws:

IfsException - if the operation fails

(Published)

hasUnassignedNodes

public boolean hasUnassignedNodes()
                           throws IfsException

Gets whether there are any unassigned Nodes in the current set of assigned nodes.

Returns:

true if there are any unassigned nodes

Throws:

IfsException - if the operation fails

(Published)

getExecutionPlanTableList

public SimplePropertyTableList getExecutionPlanTableList()
                                                  throws IfsException

Gets Reference to object holding the details describing the plan execution.

Returns:

the attribute's value

Throws:

IfsException - if the operation fails

getObjectPropertyTable

public SimplePropertyTable getObjectPropertyTable()
                                           throws IfsException

Gets the SimplePropertyTable representing this object's metadata.

Is stored as the "Object Property Table of the SimplePropertyTableList.

Returns:

the Object PropertyTable

Throws:

IfsException - if the operation fails

setActive

public void setActive(boolean active)
               throws IfsException

Sets the ACTIVE attribute for this object.

Parameters:

active - the new Active status value

Throws:

IfsException - if operation fails

(Published)

setAssignedNodes

public void setAssignedNodes(NodeState[] nodeStates)
                      throws IfsException

Sets the Nodes assigned for execution that matches the Node types indicated in the associated plan.

Parameters:

nodeStates - the new array of assigned NodeStates

Throws:

IfsException - if the operation fails

setFullyStarted

public void setFullyStarted(boolean started)
                     throws IfsException

Sets an indicator of whether this plan execution has reached a fully started state, meaning that runnables are assigned to the most appropriate Node.

Parameters:

started - true if the plan execution is fully started state; false if not

Throws:

IfsException - if the operation fails

isShutdownInProgress

public boolean isShutdownInProgress()
                             throws IfsException

Gets an indicator of whether a shutdown is in progress.

Returns:

true if a shutdown is in progress

Throws:

IfsException - if the operation fails

setShutdownInProgress

public void setShutdownInProgress(boolean val)
                           throws IfsException

Sets an indicator of whether a shutdown is in progress.

Parameters:

val - whether a shutdown is in progress

Throws:

IfsException - if the operation fails

isNormalControllerRelease

public boolean isNormalControllerRelease()
                                  throws IfsException

Gets an indicator of whether the Controller was released normally.

Returns:

true if the Controller was released normally.

Throws:

IfsException - if the operation fails

setNormalControllerRelease

public void setNormalControllerRelease(boolean val)
                                throws IfsException

Sets an indicator of whether the Controller was released normally.

Parameters:

val - whether the Controller was released normally.

Throws:

IfsException - if the operation fails

getStartupPeriod

public String getStartupPeriod()
                        throws IfsException

Gets the startup time period, which is the duration to wait while assigning Nodes before automatically changing to a "fully started" state.

Returns:

the startup time period

Throws:

IfsException - if the operation fails

getStartupPeriodDuration

public long getStartupPeriodDuration()
                              throws IfsException

Gets the startup time period duration.

Returns:

the startup time period duration

Throws:

IfsException - if the operation fails

setStartupPeriod

public void setStartupPeriod(String val)
                      throws IfsException

Sets the startup time period, which is the duration to wait while assigning Nodes before automatically changing to a "fully started" state.

Parameters:

val - the startup time period

Throws:

IfsException - if the operation fails

getRecoveryPeriod

public String getRecoveryPeriod()
                         throws IfsException

Gets the recovery time period, which is the duration to wait before returning back to a "fully started" state after one or more assigned Nodes are no longer assigned.

Returns:

the recovery time period

Throws:

IfsException - if the operation fails

getRecoveryPeriodDuration

public long getRecoveryPeriodDuration()
                               throws IfsException

Gets the recovery time period duration.

Returns:

the recovery time period duration

Throws:

IfsException - if the operation fails

setRecoveryPeriod

public void setRecoveryPeriod(String val)
                       throws IfsException

Sets the recovery time period, which is the duration to wait before returning back to a "fully started" state after one or more assigned Nodes are no longer assigned.

Parameters:

val - the recovery time period

Throws:

IfsException - if the operation fails

isEveryAssignmentFinal

public boolean isEveryAssignmentFinal()
                               throws IfsException

Gets an indicator of whether every assignment entry should be considered as being defined as "final", meaning the classification hierarchy will not be checked further if no Node is defined at the lowest defined level.

Returns:

true if every assignemnt is treated as final

Throws:

IfsException - if the operation fails

setEveryAssignmentFinal

public void setEveryAssignmentFinal(boolean val)
                             throws IfsException

Sets an indicator of whether every assignment entry should be considered as being defined as "final", meaning the classification hierarchy will not be checked further if no Node is defined at the lowest defined level.

Parameters:

val - whether every assignemnt should be treated as final

Throws:

IfsException - if the operation fails

getStartupBeginDate

public Date getStartupBeginDate()
                         throws IfsException

Gets the startup begin Date, the time/date at which starting up towards becoming fully started begins.

Returns:

the startup begin date

Throws:

IfsException - if the operation fails

setStartupBeginDate

public void setStartupBeginDate()
                         throws IfsException

Sets the startup begin Date to the current time/date.

Throws:

IfsException - if the operation fails

clearStartupBeginDate

public void clearStartupBeginDate()
                           throws IfsException

Clears the startup begin Date.

Throws:

IfsException - if the operation fails

setStartupBeginDate

public void setStartupBeginDate(Date val)
                         throws IfsException

Sets the startup begin Date to the specified value.

Parameters:

val - the startup begin Date

Throws:

IfsException - if the operation fails

startupPeriodElapsed

public boolean startupPeriodElapsed()
                             throws IfsException

See if the startup period has elapsed.

Returns:

true if the startup period has elapsed

Throws:

IfsException - if the operation fails

getRecoveryBeginDate

public Date getRecoveryBeginDate()
                          throws IfsException

Gets the recovery begin Date, the time/date at which recovery towards becoming fully started begins.

Returns:

the recovery begin date

Throws:

IfsException - if the operation fails

setRecoveryBeginDate

public void setRecoveryBeginDate()
                          throws IfsException

Sets the recovery begin Date to the current time/date.

Throws:

IfsException - if the operation fails

clearRecoveryBeginDate

public void clearRecoveryBeginDate()
                            throws IfsException

Clears the recovery begin Date.

Throws:

IfsException - if the operation fails

setRecoveryBeginDate

public void setRecoveryBeginDate(Date val)
                          throws IfsException

Sets the recovery begin Date to the specified value.

Parameters:

val - the recovery begin Date

Throws:

IfsException - if the operation fails

recoveryPeriodElapsed

public boolean recoveryPeriodElapsed()
                              throws IfsException

See if the recovery period has elapsed.

Returns:

true if the recovery period has elapsed

Throws:

IfsException - if the operation fails

isShorthanded

public boolean isShorthanded()
                      throws IfsException

Gets an indicator of whether we were shorthanded when going into "Fully Started" mode, indicating that a rebalnce operation will be required once all Nodes ae restarted.

Returns:

true if marked as being shorthanded

Throws:

IfsException - if the operation fails

setShorthanded

public void setShorthanded(boolean val)
                    throws IfsException

Sets an indicator of whether we were shorthanded when going into "Fully Started" mode, indicating that a rebalnce operation will be required once all Nodes ae restarted.

Parameters:

val - whether to mark being shorthanded

Throws:

IfsException - if the operation fails

isRecalculationNeeded

public boolean isRecalculationNeeded()
                              throws IfsException

Gets an indicator of whether recalculation of assignemnt counts is needed.

Returns:

true if recalculation of assignemnt counts is needed

Throws:

IfsException - if the operation fails

setRecalculationNeeded

public void setRecalculationNeeded(boolean val)
                            throws IfsException

Sets an indicator of whether recalculation of assignemnt counts is needed.

Parameters:

val - whether recalculation of assignemnt counts is needed

Throws:

IfsException - if the operation fails

getAssignments

public List<AttributeValueTable> getAssignments()
                                         throws IfsException

Gets the set of assignment definitions for this plan execution.

Parameters:

assList - the set assignment value tables

Throws:

IfsException - if the operation fails

performTimedDuties

public void performTimedDuties()
                        throws IfsException

Perform timed duties.

Throws:

IfsException - if the operation fails

(Published)

addRunningNodeState

public void addRunningNodeState(NodeState newNode)
                         throws IfsException

Add a new NodeState to the set of available NodeStates managed by this instance.

Parameters:

ns - the new NodeState to add

Throws:

IfsException - if the operation fails

(Published)

createAssignedServerState

public ServerState createAssignedServerState(ServerSpecification spec)
                                      throws IfsException

Get an available NodeState to assign for the specified ServerSpecification and if found, create a ServerState the Controller can request to start new.

Parameters:

spec - the ServerSpecification

Returns:

the created ServerState, or null if no suitable NodeState could be found

Throws:

IfsException - if the operation fails

(Published)

createAssignedHandlerState

public HandlerState createAssignedHandlerState(AuditSpecification spec)
                                        throws IfsException

Get an available NodeState to assign for the specified Handler.

Parameters:

spec - the AuditSpecification representing the Handler

Returns:

the chosen NodeState, or null if no suitable NodeState could be found

Throws:

IfsException - if the operation fails

(Published)