Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV PACKAGE NEXT PACKAGE | FRAMES NO FRAMES

## Package com.sun.mfwk.cib.states

This package provides interfaces that should be implemented by each CIB State provider.

See:
Description

Interface Summary
CIBAvailabilityStatusState | The State model specifies the attributes that a compliant Java ES managed object must implement.
CIBOperationalStatusState | The State model specifies the attributes that a compliant JES managed object must implement.
CIBState | Provides methods that should be implemented by a CIBState object

## Package com.sun.mfwk.cib.states Description

This package provides interfaces that should be implemented by each CIB State provider. A default implementation of each interface is provided into the CIB/SDK packages and sub-packages.

## Overview

The com.sun.mfwk.cib.states package provides interfaces that have to be implemented by each Operational Status provider object and each Availability Status provider object. A State provider (Operational status or Availability Status providers) object is an object which allows to send back the operational status and the availability status of a managed resource (an application, a service, an external resource or a resource) to its associated monitored object (CIBApplication, CIBService, CIBExternalResource or a CIBResource) through the CIBProviderHandler. Each state provider is a CIBProvider and so, has to provide an "init/destroy" methods that will be called by the monitored object to initialize and/or destroy the State provider. The initialization of the provider could consist into the creation of a communication channel with the running application instance.
The following diagram shows the relationships between a CIBMonitoredObject, its CIBProviderHandler and its associated providers : CIBConfiguration, CIBOperationalStatusState, CIBAvailabilityStatusState and CIBPerfStats. In particular, the CIBProviderHandler sent back to the CIBMonitoredObject the CIBAvailabiltiyStatusState and the CIBAvailabilityStatusState providers.
This package defines two specific types of state providers :

- CIBOperationalStatusState providing :

- the current operational status of the monitored object through the "getState" method,
- the last time on which the operational status has changed state through the "getLastChange" method,
- a string allowing to get a human readable operational status though the "toStateString" method,
- the time of which the state is entered into a running state though the "getStartTime" method.

- CIBAvailabilityStatusState providing :

- the current availability status of the monitored object through the "getState" method,
- the last time on which the availability status has changed state through the "getLastChange" method,
- a string allowing to get a human readable availability status though the "toStateString" method,
- the time of which the state is entered into a degraded state though the "getDegraded Time" method.

## States Model

## Operational Status

Each monitored object implementing CIBMonitoredObjectMBean of the Core information base should provide an Operational Status.

- com.sun.mfwk.cib.states.CIBOperationalStatusState.STARTING

- Indicates that the managed object is in the process of starting. Support of the STARTING state is optional for all managed objects implementing the State model.

- com.sun.mfwk.cib.states.CIBOperationalStatusState.RUNNING

- Indicates that the managed object is operational and ready to handle requests. Support of the RUNNING state is required for all managed objects implementing the State model.

- com.sun.mfwk.cib.states.CIBOperationalStatusState.STOPPING

- Indicates that the managed object has entered a quiet state. The managed object is no longer operational and may not be able to handle further requests. Support of the STOPPING state is optional for the managed objects supporting the State model.

- com.sun.mfwk.cib.states.CIBOperationalStatusState.STOPPED

- Indicates that the monitoring object has stopped and can be restarted. Support of the STOPPED state is required by all managed objects implementing the State model.

- com.sun.mfwk.cib.states.CIBOperationalStatusState.FAILED

- Indicates that the managed object has unexpectedly stopped. Support of the FAILED state is required by all managed objects implementing the State model.

## Availability Status

Each monitored object implementing CIBMonitoredObjectMBean of the Core information base should provide an Availabilty Status.

- com.sun.mfwk.cib.states.CIBAvailabilityStatusState.NORMAL

- Indicates that the managed object is in RUNNING state and perform normally.

- com.sun.mfwk.cib.states.CIBAvailabilityStatusState.DEGRADED

- Indicates that the managed object is in RUNNING state and is experiencing degraded operating conditions due to a high rate of errors. Support of the DEGRADED state is optional for the managed objects implementing the State model.

- com.sun.mfwk.cib.states.CIBAvailabilityStatusState.CONGESTED

- Indicates that the managed object is RUNNING state but is experiencing degraded operating conditions due to an overload. Support of the CONGESTED state is optional for the managed objects implementing the State model.

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV PACKAGE NEXT PACKAGE | FRAMES NO FRAMES