ConfigurationMBean
, DescriptorBean
, javax.management.DynamicMBean
, javax.management.MBeanRegistration
, javax.management.NotificationBroadcaster
, SettableBean
, WebLogicMBean
CpuUtilizationMBean
, FileOpenMBean
, HeapRetainedMBean
public interface RCMResourceMBean extends ConfigurationMBean
This mbean is used to create Trigger (Usage limit) based policies for a resource type.
Trigger (Usage limit) based policies allows a system administrator to establish usage limits, and define recourse actions that must be executed when those usage limits are breached.
A trigger is a static upper-limit of usage of a resource. When the consumption of that resource crosses the specified limit, the specified recourse action is performed. This policy type is best suited for environments where the resource usage by Domain Partitions are predictable.
As an example, a system administrator may limit the "Bayland" Partition to not use more than 100 open files, by setting a Trigger for 100 units of the "File Open" resource type in the resource-manager for the "Bayland" Partition.
Recourse Actions
The following recourse actions may be configured when a resource's trigger value is breached:
The following requirements are validated during trigger creation:
Trigger creation is failed if any of these requirements fail.
DEFAULT_EMPTY_BYTE_ARRAY
Modifier and Type | Method | Description |
---|---|---|
TriggerMBean |
createTrigger(java.lang.String name) |
This is the factory method for trigger configurations for this resource
type.
|
TriggerMBean |
createTrigger(java.lang.String name,
long value,
java.lang.String action) |
This is the factory method for trigger configurations for this resource
type.
|
void |
destroyTrigger(TriggerMBean triggerMBean) |
Destroys and removes a trigger configuration corresponding to the {code
triggerMBean} parameter, which is a child of this resource type MBean.
|
TriggerMBean[] |
getTriggers() |
Gets the list of configured trigger based policies for the current
resource type.
|
TriggerMBean |
lookupTrigger(java.lang.String name) |
Looks up a trigger configuration from the list of triggers configured in
this resource type.
|
freezeCurrentValue, getId, getInheritedProperties, getName, getNotes, isDynamicallyCreated, isInherited, isSet, restoreDefaultValue, setComments, setDefaultedMBean, setName, setNotes, setPersistenceEnabled, unSet
addPropertyChangeListener, createChildCopyIncludingObsolete, getParentBean, isEditable, removePropertyChangeListener
getAttribute, getAttributes, invoke, setAttribute, setAttributes
postDeregister, postRegister, preDeregister, preRegister
addNotificationListener, getNotificationInfo, removeNotificationListener
getMBeanInfo, getObjectName, getParent, getType, isCachingDisabled, isRegistered, setParent
TriggerMBean[] getTriggers()
TriggerMBean
representing the configured trigger policies in this resource
type.TriggerMBean lookupTrigger(java.lang.String name)
name
- Name of the trigger configuration to lookup.TriggerMBean
representing the trigger policy in this
resource type whose name is the name
parameter.TriggerMBean createTrigger(java.lang.String name)
The new TriggerMBean
that is created will have the resource type
MBean as its parent and must be destroyed with the
destroyTrigger(TriggerMBean)
method.
name
- Name of the trigger configurationTriggerMBean
representing the new trigger.TriggerMBean createTrigger(java.lang.String name, long value, java.lang.String action)
The new TriggerMBean
that is created will have the resource type
MBean as its parent and must be destroyed with the
destroyTrigger(TriggerMBean)
method.
name
- Name of the trigger configurationvalue
- The upper-limit of usage of the resource, beyond which the
specified action must be taken.action
- The recourse action to be taken when the usage of resoure
crosses the value specified in the value parameter. See the class
documentation of RCMResourceMBean for a set of allowed recourse actions
types. Refer the Resource type MBean to obtain the subset of valid recourse
action types for the Resource type.TriggerMBean
representing the new trigger.void destroyTrigger(TriggerMBean triggerMBean)
triggerMBean
- The TriggerMBean to be removed from this resource type MBean.