com.whitestein.lsps.stdlib.function

Interface RestartFunctions

All Known Implementing Classes:

RestartFunctionsImpl

public interface RestartFunctions

Functions that perform restart related actions.

Author:

pna

Method Summary

Modifier and Type	Method and Description
void	clearApplicationRestartData(ExecutionContext context) Clears the information about previous application restart.
void	explicitFinishing(ExecutionContext context) Specifies that the current model instance starting is finished explicitly, by calling the modelInstanceStartSucceeded() function.
EnumerationImpl	getStartStatus(ExecutionContext context, RecordHolder modelInstance) Return start status for given model instance
MapHolder	getStartStatuses(ExecutionContext context, SetHolder modelInstances) Return start statuses for given model instances
void	modelInstanceStartSucceeded(ExecutionContext context) Tells that the model instance starting succeded.
void	setCountOfModelInstancesToStart(ExecutionContext context, Decimal count) Sets the number of model instances to be restarted.
void	watchStarting(ExecutionContext context, RecordHolder modelInstance) Adds the model instance to a list of started model instances.

Method Detail

clearApplicationRestartData

void clearApplicationRestartData(ExecutionContext context)

Clears the information about previous application restart. Technically, it removes all records in the LSPS_APPL_RESTART_INFO table and sets the NUMBER_OF_MODEL_INSTANCES_TO_START in LSPS_VALUES to -1.

Parameters:

context -

watchStarting

void watchStarting(ExecutionContext context,
                   RecordHolder modelInstance)

Adds the model instance to a list of started model instances. If the LSPS_APPL_RESTART_INFO table does not contain this model instance yet, it is being added. If the modelInstance parameter is is null the current model instance is used. Creating new record in the it sets ID, MODEL_INSTANCE, STATUS to IN_PROGRESS and START_DATE to the current time.

Parameters:

context -

modelInstance -

modelInstanceStartSucceeded

void modelInstanceStartSucceeded(ExecutionContext context)

Tells that the model instance starting succeded. The FINISHED status is written to the LSPS_APPL_RESTART_INFO table on successful commit of the current GO-BOMN transaction unless an exception occurred.

Parameters:

context -

explicitFinishing

void explicitFinishing(ExecutionContext context)

Specifies that the current model instance starting is finished explicitly, by calling the modelInstanceStartSucceeded() function. If the current mode instance is in the LSPS_APPL_RESTART_INFO table and its status is IN_PROGRESS, this function changes the status to IN_PROGRESS_EXPLICIT_FINISH. If not, this function does nothing.

Parameters:

context -

setCountOfModelInstancesToStart

void setCountOfModelInstancesToStart(ExecutionContext context,
                                     Decimal count)

Sets the number of model instances to be restarted. It can be set in advance of the actual model instance restarting. Technically, it writes the number to the LSPS_VALUES table under the COUNT_OF_MODEL_INSTANCES_TO_START key.

Parameters:

context -

count -

getStartStatus

EnumerationImpl getStartStatus(ExecutionContext context,
                               RecordHolder modelInstance)
                        throws ErrorException

Return start status for given model instance

Parameters:

context -

modelInstance -

Returns:

starting status

Throws:

ErrorException

getStartStatuses

MapHolder getStartStatuses(ExecutionContext context,
                           SetHolder modelInstances)
                    throws ErrorException

Return start statuses for given model instances

Parameters:

context -

modelInstances -

Returns:

starting statuses

Throws:

ErrorException