Skip navigation links

weblogic.management.configuration
Interface RCMResourceFairShareMBean

All Superinterfaces:

ConfigurationMBean, DescriptorBean, DynamicMBean, MBeanRegistration, NotificationBroadcaster, SettableBean, WebLogicMBean

All Known Subinterfaces:

CpuUtilizationMBean, HeapRetainedMBean

public interface RCMResourceFairShareMBean

extends ConfigurationMBean

The RCMResourceFairShareMBean is used to configure the Fair Share policy for a resource type.

A Fair share policy is typically used to ensure that a fixed-size shared resource is shared effectively (yet fairly) by competing consumers. A Fair share policy may also be employed by a system administrator when a clear understanding of the exact usage of a resource by a Partition cannot be accurately determined in advance, and the system administrator would like efficient utilization of resources while ensuring fair allocation of shared resources to co-resident Partitions.

A RCM fair-share policy provides the following assurance to the system administrator (in line with work manager's definition of fair-share): When there is "contention: for a resource, and there is "uniform load" by two resource domains "over a period of time", the share of resources allocated to the two domains is "roughly" as per the fair share configured by the system administrator for those two Domain Partitions.

A system administrator allocates a 'share' to a Partition by specifying an integer value to let the fair share policy know the share of resources that must be allocated to the Partition during contention over time. The sum of all Partition shares need not equal 100.

Since:

12.2.1.0

getFairShareConstraint

FairShareConstraintMBean getFairShareConstraint()

Gets the Fair Share policy configured for this resource type.

Returns:

FairShareConstraintMBean A FairShareConstraintMBean representing the fair share policy configured for this resource type.

createFairShareConstraint

FairShareConstraintMBean createFairShareConstraint(String name,
                                                   int value)

This is the factory method for fair share policy configurations for this resource type.

The new FairShareConstraintMBean that is created will have the resource type MBean as its parent and must be destroyed with the RCMResourceFairShareMBean.destroyFairShareConstraint(FairShareConstraintMBean) method.

Parameters:

name - Name of the fair share policy configuration

value - The share of resources that must be allocated to the Partition during contention over time

Returns:

A FairShareConstraintMBean representing the new fair share policy configuration.

destroyFairShareConstraint

void destroyFairShareConstraint(FairShareConstraintMBean fairShareConstraintMBean)

Destroys and removes a fair share policy configuration corresponding to the {code fairshareConstraintMBean} parameter, which is a child of this resource type MBean.

Parameters:

fairShareConstraintMBean - The FairShareConstraintMBean to be removed from this resource type MBean.

Skip navigation links