com.opencloud.rhino.management.resource

Interface ResourceManagementMBean

All Superinterfaces:

ResourceManagementMBean

public interface ResourceManagementMBean
extends ResourceManagementMBean

The ResourceManagementMBean interface defines resource adaptor-related management operations. This interface provides extensions to ResourceManagementMBean for additional Rhino-specific functionality.

Field Summary

Fields inherited from interface javax.slee.management.ResourceManagementMBean

OBJECT_NAME, RESOURCE_ADAPTOR_ENTITY_STATE_CHANGE_NOTIFICATION_TYPE

Method Summary

Methods

Modifier and Type	Method and Description
void	activateResourceAdaptorEntity(String entityName) Activate a resource adaptor entity on all currently live event routing nodes as determined by RhinoHousekeepingMBean.getEventRouterNodes().
void	activateResourceAdaptorEntity(String entityName, int[] nodeIDs) Activate a resource adaptor entity on the specified nodes.
void	deactivateResourceAdaptorEntity(String entityName) Deactivate a resource adaptor entity on all currently live event routing nodes as determined by RhinoHousekeepingMBean.getEventRouterNodes().
void	deactivateResourceAdaptorEntity(String entityName, int[] nodeIDs) Deactivate a resource adaptor entity on the specified nodes.
void	deactivateResourceAdaptorEntity(String entityName, int[] nodeIDs, int[] reassignActivitiesToNodeIDs) Deactivate a resource adaptor entity on the specified nodes and reassign replicated activities owned by the resource adaptor entity on the deactivating nodes to other cluster nodes.
SbbPartID[]	getBoundSbbParts(String linkName) Get the set of SBB part component identifiers that identify the SBB parts that are bound to the specified link name by way of a resource-adaptor-entity-link element in their deployment descriptor.
SbbID[]	getBoundSbbs(String linkName)
ConfigProperties	getConfigurationProperties(ResourceAdaptorID id)
ConfigProperties	getConfigurationProperties(String entityName)
String[]	getLinkNames(String entityName)
int[]	getNodes(String entityName, ResourceAdaptorEntityState state) Get the set of event-router nodes in the primary component where the resource adaptor entity is in the specified state.
ResourceAdaptorID	getResourceAdaptor(String entityName)
String[]	getResourceAdaptorEntities(ResourceAdaptorEntityState state) Get the set of resource adaptor entities that are in a particular state.
String[]	getResourceAdaptorEntities(ResourceAdaptorEntityState state, int nodeID) Get the set of resource adaptor entities that are in a particular state on the specified node.
String[]	getResourceAdaptorEntities(ResourceAdaptorID id)
String[]	getResourceAdaptorEntities(String[] linkNames)
String	getResourceAdaptorEntity(String linkName)
ObjectName	getResourceUsageMBean(String entityName)
Byte[]	getStartingPriorities(String[] entityNames) Get an array of starting priorities corresponding to an array of resource adaptor entity names.
byte	getStartingPriority(String entityName) Get the starting priority for a resource adaptor entity.
ResourceAdaptorEntityState	getState(String entityName) Get the current state of a resource adaptor entity.
ResourceAdaptorEntityState[]	getState(String entityName, int[] nodeIDs) Get the current state of a resource adaptor entity on each of the specified nodes.
Byte[]	getStoppingPriorities(String[] entityNames) Get an array of stopping priorities corresponding to an array of resource adaptor entity names.
byte	getStoppingPriority(String entityName) Get the stopping priority for a resource adaptor entity.
void	reassignActivities(String entityName, int[] fromNodeIDs, int[] toNodeIDs) Reassign replicated activities owned by a resource adaptor entity on the specified nodes to other cluster nodes.
void	setStartingPriority(String entityName, byte priority) Set the starting priority for a resource adaptor entity.
void	setStoppingPriority(String entityName, byte priority) Set the stopping priority for a resource adaptor entity.

Methods inherited from interface javax.slee.management.ResourceManagementMBean

bindLinkName, createResourceAdaptorEntity, getLinkNames, getResourceAdaptorEntities, removeResourceAdaptorEntity, unbindLinkName, updateConfigurationProperties

Method Detail

activateResourceAdaptorEntity

void activateResourceAdaptorEntity(String entityName)
                                   throws NullPointerException,
                                          UnrecognizedResourceAdaptorEntityException,
                                          InvalidStateException,
                                          ManagementException

Activate a resource adaptor entity on all currently live event routing nodes as determined by RhinoHousekeepingMBean.getEventRouterNodes(). The resource adaptor entity must be in the ResourceAdaptorEntityState.INACTIVE state on all these nodes and transitions to the ResourceAdaptorEntityState.ACTIVE state on these nodes during this method invocation.

Specified by:

activateResourceAdaptorEntity in interface ResourceManagementMBean

Parameters:

entityName - the name of the resource adaptor entity.

Throws:

NullPointerException - if entityName is null.

UnrecognizedResourceAdaptorEntityException - if entityName does not correspond with a resource adaptor entity existing in the SLEE.

InvalidStateException - if the resource adaptor entity is not in the ResourceAdaptorEntityState.INACTIVE state on all nodes.

ManagementException - if the resource adaptor entity could not be activated due to a system-level failure.

activateResourceAdaptorEntity

void activateResourceAdaptorEntity(String entityName,
                                 int[] nodeIDs)
                                   throws NullPointerException,
                                          InvalidArgumentException,
                                          UnrecognizedResourceAdaptorEntityException,
                                          InvalidStateException,
                                          ManagementException

Activate a resource adaptor entity on the specified nodes. The resource adaptor entity must be in the ResourceAdaptorEntityState.INACTIVE state on all specified nodes and transitions to the ResourceAdaptorEntityState.ACTIVE state on these nodes during this method invocation.

The specified nodes do not have to be current cluster members. For example this method can be used to set the activation state for a resource adaptor entity on nodes yet to be started.

Parameters:

entityName - the name of the resource adaptor entity.

nodeIDs - the node IDs of the nodes to activate the resource adaptor entity on.

Throws:

NullPointerException - if either argument is null.

InvalidArgumentException - if nodeIDs is zero-length or contains invalid node IDs.

UnrecognizedResourceAdaptorEntityException - if entityName does not correspond with a resource adaptor entity existing in the SLEE.

InvalidStateException - if the resource adaptor entity is not in the ResourceAdaptorEntityState.INACTIVE state on all specified nodes.

ManagementException - if the resource adaptor entity could not be activated due to a system-level failure.

deactivateResourceAdaptorEntity

void deactivateResourceAdaptorEntity(String entityName)
                                     throws NullPointerException,
                                            UnrecognizedResourceAdaptorEntityException,
                                            InvalidStateException,
                                            ManagementException

Deactivate a resource adaptor entity on all currently live event routing nodes as determined by RhinoHousekeepingMBean.getEventRouterNodes(). The resource adaptor entity must be in the ResourceAdaptorEntityState.ACTIVE state on all these nodes and transitions to the ResourceAdaptorEntityState.STOPPING state on these nodes during this method invocation. The resource adaptor entity spontaneously returns to the ResourceAdaptorEntityState.INACTIVE state on these nodes once all activities owned by the resource adaptor entity on these nodes have ended.

Specified by:

deactivateResourceAdaptorEntity in interface ResourceManagementMBean

Parameters:

entityName - the name of the resource adaptor entity.

Throws:

NullPointerException - if entityName is null.

UnrecognizedResourceAdaptorEntityException - if entityName does not correspond with a resource adaptor entity existing in the SLEE.

InvalidStateException - if the resource adaptor entity is not in the ResourceAdaptorEntityState.ACTIVE state on all nodes.

ManagementException - if the resource adaptor entity could not be deactivated due to a system-level failure.

deactivateResourceAdaptorEntity

void deactivateResourceAdaptorEntity(String entityName,
                                   int[] nodeIDs)
                                     throws NullPointerException,
                                            InvalidArgumentException,
                                            UnrecognizedResourceAdaptorEntityException,
                                            InvalidStateException,
                                            ManagementException

Deactivate a resource adaptor entity on the specified nodes. The resource adaptor entity must be in the ResourceAdaptorEntityState.ACTIVE state on all specified nodes and transitions to the ResourceAdaptorEntityState.STOPPING state on these nodes during this method invocation. The resource adaptor entity spontaneously returns to the ResourceAdaptorEntityState.INACTIVE state on these nodes once all activities owned by the resource adaptor entity on these nodes have ended.

The specified nodes do not have to be current cluster members. For example this method can be used to set the activation state for a resource adaptor entity on nodes yet to be started.

If the resource adaptor entity owns replicated activities on the deactivating nodes then those activities are left to drain normally by this method. If ownership of these activities should be reassigned to allow the resource adaptor entity to return to the ResourceAdaptorEntityState.INACTIVE state quicker then deactivateResourceAdaptorEntity(String, int[], int[]) should be used instead. Alternatively reassignActivities(String, int[], int[]) may be used after deactivation to perform this reassignment.

Parameters:

entityName - the name of the resource adaptor entity.

nodeIDs - the node IDs of the nodes to deactivate the resource adaptor entity on.

Throws:

NullPointerException - if either argument is null.

InvalidArgumentException - if nodeIDs is zero-length or contains invalid node IDs.

UnrecognizedResourceAdaptorEntityException - if entityName does not correspond with a resource adaptor entity existing in the SLEE.

InvalidStateException - if the resource adaptor entity is not in the ResourceAdaptorEntityState.ACTIVE state on all specified nodes.

ManagementException - if the resource adaptor entity could not be deactivated due to a system-level failure.

deactivateResourceAdaptorEntity

void deactivateResourceAdaptorEntity(String entityName,
                                   int[] nodeIDs,
                                   int[] reassignActivitiesToNodeIDs)
                                     throws NullPointerException,
                                            InvalidArgumentException,
                                            UnrecognizedResourceAdaptorEntityException,
                                            InvalidStateException,
                                            ManagementException

Deactivate a resource adaptor entity on the specified nodes and reassign replicated activities owned by the resource adaptor entity on the deactivating nodes to other cluster nodes. The resource adaptor entity must be in the ResourceAdaptorEntityState.ACTIVE state on all specified nodes and transitions to the ResourceAdaptorEntityState.STOPPING state on these nodes during this method invocation. The resource adaptor entity spontaneously returns to the ResourceAdaptorEntityState.INACTIVE state on the deactivating nodes once all non-replicated activities owned by the resource adaptor entity on these nodes have ended.

The specified nodes on which to deactivate the resource adaptor do not have to be current cluster members. For example this method can be used to set the activation state for a resource adaptor entity on nodes yet to be started.

This method has several modes of operation, depending on the value of the reassignActivitiesToNodeIDs parameter:

• if reassignActivitiesToNodeIDs is null, this method behaves in the same way as the deactivateResourceAdaptorEntity(String, int[]) method, ie. no replicated activity reassignment takes place
• if reassignActivitiesToNodeIDs is a zero-length array, replicated activities will be reassigned to any other cluster nodes that are capable of taking ownership of the activities; if no nodes satisfy this criteria no activity reassignment takes place
• if reassignActivitiesToNodeIDs is an array with at least one element, replicated activities will be reassigned to the specified node(s)

Replicated activities for a resource adaptor entity may only be reassigned from a node if the node meets the following conditions:

• the node is a live cluster member providing event routing functions, ie. not a quorum node
• the resource adaptor entity is in the ResourceAdaptorEntityState.ACTIVE state on the node prior to deactivation
• the SLEE is in the SleeState.RUNNING or SleeState.STOPPING state on the node

Replicated activities for a resource adaptor entity may only be reassigned to a node if the node meets the following conditions:

• the node is a live cluster member providing event routing functions, ie. not a quorum node
• the resource adaptor entity is in the ResourceAdaptorEntityState.ACTIVE state on the node
• the SLEE is in the SleeState.RUNNING state on the node

Parameters:

entityName - the name of the resource adaptor entity.

nodeIDs - the node IDs of the nodes to deactivate the resource adaptor entity on.

reassignActivitiesToNodeIDs - the set of nodes to reassign replicated activities to.

Throws:

NullPointerException - if entityName or nodeIDs is null.

InvalidArgumentException - if nodeIDs is zero-length or contains invalid node IDs, or if reassignActivitiesToNodeIDs is non-null but the resource adaptor entity is not replicating or if the target nodes are invalid.

UnrecognizedResourceAdaptorEntityException - if entityName does not correspond with a resource adaptor entity existing in the SLEE.

InvalidStateException - if the resource adaptor entity is not in the ResourceAdaptorEntityState.ACTIVE state on all specified nodes.

ManagementException - if the resource adaptor entity could not be deactivated due to a system-level failure.

reassignActivities

void reassignActivities(String entityName,
                      int[] fromNodeIDs,
                      int[] toNodeIDs)
                        throws NullPointerException,
                               InvalidArgumentException,
                               UnrecognizedResourceAdaptorEntityException,
                               InvalidStateException,
                               ManagementException

Reassign replicated activities owned by a resource adaptor entity on the specified nodes to other cluster nodes. The resource adaptor entity must be a replicating resource adaptor entity.

This method has two modes of operation, depending on the value of the toNodeIDs parameter:

• if toNodeIDs is a zero-length array, replicated activities will be reassigned to any other cluster nodes that are capable of taking ownership of the activities
• if toNodeIDs is an array with at least one element, replicated activities will be reassigned to the specified node(s)

Replicated activities for a resource adaptor entity may only be reassigned from a node if the node meets the following conditions:

• the node is a live cluster member providing event routing functions, ie. not a quorum node
• the resource adaptor entity is in the ResourceAdaptorEntityState.ACTIVE or ResourceAdaptorEntityState.STOPPING state on the node
• the SLEE is in the SleeState.RUNNING or SleeState.STOPPING state on the node

Replicated activities for a resource adaptor entity may only be reassigned to a node if the node meets the following conditions:

• the node is a live cluster member providing event routing functions, ie. not a quorum node
• the resource adaptor entity is in the ResourceAdaptorEntityState.ACTIVE state on the node
• the SLEE is in the SleeState.RUNNING state on the node

Parameters:

entityName - the name of the resource adaptor entity.

fromNodeIDs - the node IDs of the nodes to reassign activities from.

toNodeIDs - the node IDs of the nodes to reassign the activities to.

Throws:

NullPointerException - if any argument is null.

InvalidArgumentException - if entityName does not correspond with a replicating resource adaptor, or if fromNodeIDs is zero-length or contains invalid node IDs, or if toNodeIDs is contains invalid node IDs.

UnrecognizedResourceAdaptorEntityException - if entityName does not correspond with a resource adaptor entity existing in the SLEE.

InvalidStateException - if the resource adaptor entity is not in the ResourceAdaptorEntityState.ACTIVE or ResourceAdaptorEntityState.STOPPING state and the SLEE is not in the SleeState.RUNNING or SleeState.STOPPING state on the all specified nodes, or if toNodeIDs is zero-length and there are no remaining nodes that the activities may be reassigned to.

ManagementException - if the activities could not be reassigned due to a system-level failue.

getState

ResourceAdaptorEntityState getState(String entityName)
                                    throws NullPointerException,
                                           UnrecognizedResourceAdaptorEntityException,
                                           ManagementException

Get the current state of a resource adaptor entity. This method returns the state of the resource adaptor entity on the node the management client directs the method call at, as determined by RhinoHousekeepingMBean.getNodeID().

Specified by:

getState in interface ResourceManagementMBean

Parameters:

entityName - the name of the resource adaptor entity.

Returns:

the current state of the resource adaptor entity on the invoked node.

Throws:

NullPointerException - if entityName is null.

UnrecognizedResourceAdaptorEntityException - if entityName does not correspond with a resource adaptor entity existing in the SLEE.

ManagementException - if the state of the resource adaptor entity could not be obtained due to a system-level failure.

getState

ResourceAdaptorEntityState[] getState(String entityName,
                                    int[] nodeIDs)
                                      throws NullPointerException,
                                             InvalidArgumentException,
                                             UnrecognizedResourceAdaptorEntityException,
                                             ManagementException

Get the current state of a resource adaptor entity on each of the specified nodes.

Parameters:

entityName - the name of the resource adaptor entity.

nodeIDs - the node IDs of the nodes to return the resource adaptor entity's state for.

Returns:

an array of resource adaptor entity state objects. This array will be the same length as the supplied nodeIDs array, and if states = getState(entityName, nodeIDs) then states[i] equals the state of the resource adaptor entity on node nodeIDs[i]. If there is no state information for the resource adaptor entity on a particular node, ResourceAdaptorEntityState.INACTIVE is returned as the resulting state for the resource adaptor entity on that node.

Throws:

NullPointerException - if either argument is null.

InvalidArgumentException - if nodeIDs contains invalid node IDs.

UnrecognizedResourceAdaptorEntityException - if entityName does not correspond with a resource adaptor entity existing in the SLEE.

ManagementException - if the state of the resource adaptor entity could not be obtained due to a system-level failure.

getResourceAdaptorEntities

String[] getResourceAdaptorEntities(ResourceAdaptorEntityState state)
                                    throws NullPointerException,
                                           ManagementException

Get the set of resource adaptor entities that are in a particular state. This method returns the set of Services in the specified state on the node the management client directs this method call at, as determined by RhinoHousekeepingMBean.getNodeID().

Specified by:

getResourceAdaptorEntities in interface ResourceManagementMBean

Parameters:

state - the required state.

Returns:

an array of strings identifying the resource adaptor entities that are in the specified state on the invoked node.

Throws:

NullPointerException - if state is null.

ManagementException - if the identifiers could not be obtained due to a system-level failure.

getResourceAdaptorEntities

String[] getResourceAdaptorEntities(ResourceAdaptorEntityState state,
                                  int nodeID)
                                    throws NullPointerException,
                                           InvalidArgumentException,
                                           ManagementException

Get the set of resource adaptor entities that are in a particular state on the specified node.

The specified node does not have to be a current cluster member. For example this method can be used to query the activation state for a resource adpator entity on a node yet to be started.

Parameters:

state - the required state.

Returns:

an array of strings identifying the resource adaptor entities that are in the specified state on the specified node.

Throws:

NullPointerException - if state is null.

InvalidArgumentException - if nodeID is an invalid node ID.

ManagementException - if the identifiers could not be obtained due to a system-level failure.

getNodes

int[] getNodes(String entityName,
             ResourceAdaptorEntityState state)
               throws NullPointerException,
                      UnrecognizedResourceAdaptorEntityException,
                      ManagementException

Get the set of event-router nodes in the primary component where the resource adaptor entity is in the specified state.

Parameters:

entityName - the name of the resource adaptor entity.

state - the required state.

Returns:

an array of node IDs identifying the event-router nodes where the resource adaptor entity is in the specified state.

Throws:

NullPointerException - if either argument is null.

UnrecognizedResourceAdaptorEntityException - if entityName does not correspond with a resource adaptor entity existing in the SLEE.

ManagementException - if the set of nodes where the resource adaptor entity is in the required state could not be determined due to a system-level failure.

setStartingPriority

void setStartingPriority(String entityName,
                       byte priority)
                         throws NullPointerException,
                                UnrecognizedResourceAdaptorEntityException,
                                ManagementException

Set the starting priority for a resource adaptor entity. The starting priority determines the order in which services and resource adaptor entities together are started when the SLEE transitions from the STOPPED state to the RUNNING state.

Priorities are values between -128 and 127. If a component (service or resource adaptor entity), X, has a numerically higher priority value than another component, Y, then X will be started before Y. Components with the same priority may be started in an arbitrary order, or may be started concurrently.

Parameters:

entityName - the name of the resource adaptor entity.

priority - the starting priority for the resource adaptor entity.

Throws:

NullPointerException - if entityName is null.

UnrecognizedResourceAdaptorEntityException - if entityName does not correspond with a resource adaptor entity existing in the SLEE.

ManagementException - if the starting priority of the resource adaptor entity could not be updated due to a system-level failure.

Since:

Rhino 2.4.0

See Also:

setStoppingPriority(String, byte)

getStartingPriority

byte getStartingPriority(String entityName)
                         throws NullPointerException,
                                UnrecognizedResourceAdaptorEntityException,
                                ManagementException

Get the starting priority for a resource adaptor entity.

Parameters:

entityName - the name of the resource adaptor entity.

Returns:

the starting priority of the resource adaptor entity.

Throws:

NullPointerException - if id is null.

UnrecognizedResourceAdaptorEntityException - if entityName does not correspond with a resource adaptor entity existing in the SLEE.

ManagementException - if the starting priority of the resource adaptor entity could not be obtained due to a system-level failure.

Since:

Rhino 2.4.0

See Also:

setStartingPriority(String, byte)

getStartingPriorities

Byte[] getStartingPriorities(String[] entityNames)
                             throws NullPointerException,
                                    ManagementException

Get an array of starting priorities corresponding to an array of resource adaptor entity names.

Parameters:

entityNames - the array of resource adaptor entity names.

Returns:

an array of starting priorities. This array will be the same length as the supplied array, and if priorities = getStartingPriorities(entityNames) then priorities[i] == getStartingPriority(entityNames[i]). Any unrecognised resource adaptor entity name present in entityNames results in a null value at the corresponding array index in this array.

Throws:

NullPointerException - if entityNames is null.

ManagementException - if the starting priorities could not be obtained due to a system-level failure.

Since:

Rhino 2.4.0

setStoppingPriority

void setStoppingPriority(String entityName,
                       byte priority)
                         throws NullPointerException,
                                UnrecognizedResourceAdaptorEntityException,
                                ManagementException

Set the stopping priority for a resource adaptor entity. The stopping priority determines the order in which services and resource adaptor entities together are started when the SLEE transitions from the RUNNING state to the STOPPING state.

Priorities are values between -128 and 127. If a component (service or resource adaptor entity), X, has a numerically higher priority value than another component, Y, then X will be started before Y. Components with the same priority may be started in an arbitrary order, or may be started concurrently.

Parameters:

entityName - the name of the resource adaptor entity.

priority - the stopping priority for the resource adaptor entity.

Throws:

NullPointerException - if entityName is null.

UnrecognizedResourceAdaptorEntityException - if entityName does not correspond with a resource adaptor entity existing in the SLEE.

ManagementException - if the stopping priority of the resource adaptor entity could not be updated due to a system-level failure.

Since:

Rhino 2.4.0

See Also:

setStartingPriority(String, byte)

getStoppingPriority

byte getStoppingPriority(String entityName)
                         throws NullPointerException,
                                UnrecognizedResourceAdaptorEntityException,
                                ManagementException

Get the stopping priority for a resource adaptor entity.

Parameters:

entityName - the name of the resource adaptor entity.

Returns:

the stopping priority of the resource adaptor entity.

Throws:

NullPointerException - if id is null.

UnrecognizedResourceAdaptorEntityException - if entityName does not correspond with a resource adaptor entity existing in the SLEE.

ManagementException - if the stopping priority of the resource adaptor entity could not be obtained due to a system-level failure.

Since:

Rhino 2.4.0

See Also:

setStartingPriority(String, byte)

getStoppingPriorities

Byte[] getStoppingPriorities(String[] entityNames)
                             throws NullPointerException,
                                    ManagementException

Get an array of stopping priorities corresponding to an array of resource adaptor entity names.

Parameters:

entityNames - the array of resource adaptor entity names.

Returns:

an array of stopping priorities. This array will be the same length as the supplied array, and if priorities = getStoppingPriorities(entityNames) then priorities[i] == getStoppingPriority(entityNames[i]). Any unrecognised resource adaptor entity name present in entityNames results in a null value at the corresponding array index in this array.

Throws:

NullPointerException - if entityNames is null.

ManagementException - if the stopping priorities could not be obtained due to a system-level failure.

Since:

Rhino 2.4.0

getResourceAdaptorEntities

String[] getResourceAdaptorEntities(ResourceAdaptorID id)
                                    throws NullPointerException,
                                           UnrecognizedResourceAdaptorException,
                                           ManagementException

Specified by:

getResourceAdaptorEntities in interface ResourceManagementMBean

Throws:

NullPointerException

UnrecognizedResourceAdaptorException

ManagementException

getResourceAdaptorEntities

String[] getResourceAdaptorEntities(String[] linkNames)
                                    throws NullPointerException,
                                           ManagementException

Specified by:

getResourceAdaptorEntities in interface ResourceManagementMBean

Throws:

NullPointerException

ManagementException

getConfigurationProperties

ConfigProperties getConfigurationProperties(ResourceAdaptorID id)
                                            throws NullPointerException,
                                                   UnrecognizedResourceAdaptorException,
                                                   ManagementException

Specified by:

getConfigurationProperties in interface ResourceManagementMBean

Throws:

NullPointerException

UnrecognizedResourceAdaptorException

ManagementException

getConfigurationProperties

ConfigProperties getConfigurationProperties(String entityName)
                                            throws NullPointerException,
                                                   UnrecognizedResourceAdaptorEntityException,
                                                   ManagementException

Specified by:

getConfigurationProperties in interface ResourceManagementMBean

Throws:

NullPointerException

UnrecognizedResourceAdaptorEntityException

ManagementException

getResourceAdaptor

ResourceAdaptorID getResourceAdaptor(String entityName)
                                     throws NullPointerException,
                                            UnrecognizedResourceAdaptorEntityException,
                                            ManagementException

Specified by:

getResourceAdaptor in interface ResourceManagementMBean

Throws:

NullPointerException

UnrecognizedResourceAdaptorEntityException

ManagementException

getLinkNames

String[] getLinkNames(String entityName)
                      throws NullPointerException,
                             UnrecognizedResourceAdaptorEntityException,
                             ManagementException

Specified by:

getLinkNames in interface ResourceManagementMBean

Throws:

NullPointerException

UnrecognizedResourceAdaptorEntityException

ManagementException

getBoundSbbs

SbbID[] getBoundSbbs(String linkName)
                     throws NullPointerException,
                            UnrecognizedLinkNameException,
                            ManagementException

Specified by:

getBoundSbbs in interface ResourceManagementMBean

Throws:

NullPointerException

UnrecognizedLinkNameException

ManagementException

getBoundSbbParts

SbbPartID[] getBoundSbbParts(String linkName)
                             throws UnrecognizedLinkNameException,
                                    ManagementException

Get the set of SBB part component identifiers that identify the SBB parts that are bound to the specified link name by way of a resource-adaptor-entity-link element in their deployment descriptor.

Parameters:

linkName - the link name.

Returns:

an array of SBB part component identifiers identifying the SBBs that are bound to the link name.

Throws:

NullPointerException - if linkName is null.

UnrecognizedLinkNameException - if linkName has not been bound to a resource adaptor entity.

ManagementException - if the SBB part component identifiers could not be obtained due to a system-level failure.

Since:

Rhino 2.4.0

getResourceAdaptorEntity

String getResourceAdaptorEntity(String linkName)
                                throws NullPointerException,
                                       UnrecognizedLinkNameException,
                                       ManagementException

Specified by:

getResourceAdaptorEntity in interface ResourceManagementMBean

Throws:

NullPointerException

UnrecognizedLinkNameException

ManagementException

getResourceUsageMBean

ObjectName getResourceUsageMBean(String entityName)
                                 throws NullPointerException,
                                        UnrecognizedResourceAdaptorEntityException,
                                        InvalidArgumentException,
                                        ManagementException

Specified by:

getResourceUsageMBean in interface ResourceManagementMBean

Throws:

NullPointerException

UnrecognizedResourceAdaptorEntityException

InvalidArgumentException

ManagementException