javax.slee.management

Interface ProfileTableUsageMBean

public interface ProfileTableUsageMBean

The ProfileTableUsageMBean interface defines profile table usage-related management operations. Using a ProfileTableUsageMBean object a management client may get access to UsageMBean objects for a profile table, or modify the list of named usage parameter sets profiles in a profile table are allowed to use.

The base JMX Object Name of a ProfileTableUsageMBean object is specified by the BASE_OBJECT_NAME constant. The PROFILE_TABLE_NAME_KEY constant defines an additional Object Name property that uniquely identifies a Profile Table Usage MBean. The complete Object Name of a ProfileTableUsageMBean object can be obtained by a management client via the ProfileProvisioningMBean.getProfileTableUsageMBean(java.lang.String) method.

Since:

SLEE 1.1

Field Summary

Fields

Modifier and Type	Field and Description
static String	BASE_OBJECT_NAME The base JMX Object Name string of all SLEE Profile Table Usage MBeans.
static String	PROFILE_TABLE_NAME_KEY The JMX Object Name property key that identifies the name of the profile table that the Profile Table Usage MBean is providing usage-related management operations for.

Method Summary

Methods

Modifier and Type	Method and Description
void	close() Notify the SLEE that the Profile Table Usage MBean is no longer required by the management client.
void	createUsageParameterSet(String paramSetName) Create a new usage parameter set that the profiles in the profile table that this MBean is providing usage acces for are permitted to use in the one-argument form of the get-usage-parameters method.
String	getProfileTableName() Get the name of the profile table that this MBean provides usage management access for.
ObjectName	getUsageMBean() Get the JMX Object Name of a UsageMBean object that provides management access to the unnamed usage parameter set for the profile table that this MBean is providing usage management access for.
ObjectName	getUsageMBean(String paramSetName) Get the JMX Object Name of a UsageMBean object that provides management access to the named usage parameter set for the profile table that this MBean is providing usage management access for.
ObjectName	getUsageNotificationManagerMBean() Get the JMX Object Name of a UsageNotificationManagerMBean that provides management access to the usage notification manager for the profile table that this MBean is providing usage management access for.
String[]	getUsageParameterSets() Get the names of the usage parameter sets that have been created for the profile table that this MBean is providing usage management access for.
void	removeUsageParameterSet(String paramSetName) Remove an existing usage parameter set from the profile table that this MBean is providing usage management access for.
void	resetAllUsageParameters() Reset all usage parameters in the unamed usage parameter set, and all named usage parameter sets, of the profile table that this MBean is providing usage management access for.

Field Detail

BASE_OBJECT_NAME

static final String BASE_OBJECT_NAME

The base JMX Object Name string of all SLEE Profile Table Usage MBeans. This string is equal to "javax.slee.management.usage:type=ProfileTableUsage" and the string BASE_OBJECT_NAME + ",*" defines a JMX Object Name property pattern which matches with all Profile Table Usage MBeans that are registered with the MBean Server. A Profile Table Usage MBean is registered with the MBean Server using this base name in conjunction with properties whose keys are specified by the PROFILE_TABLE_NAME_KEY constant.

See Also:

Constant Field Values

PROFILE_TABLE_NAME_KEY

static final String PROFILE_TABLE_NAME_KEY

The JMX Object Name property key that identifies the name of the profile table that the Profile Table Usage MBean is providing usage-related management operations for. This key is equal to the string "profileTableName".

See Also:

Constant Field Values

Method Detail

getProfileTableName

String getProfileTableName()
                           throws ManagementException

Get the name of the profile table that this MBean provides usage management access for.

Returns:

the name of the profile table.

Throws:

ManagementException - if the profile table name could not be obtained due to a system-level failure.

createUsageParameterSet

void createUsageParameterSet(String paramSetName)
                             throws NullPointerException,
                                    InvalidArgumentException,
                                    UsageParameterSetNameAlreadyExistsException,
                                    ManagementException

Create a new usage parameter set that the profiles in the profile table that this MBean is providing usage acces for are permitted to use in the one-argument form of the get-usage-parameters method.

Parameters:

paramSetName - the usage parameter set name. Names must be non-null and greater than 0 in length.

Throws:

NullPointerException - if paramSetName is null.

InvalidArgumentException - if paramSetName is zero-length.

UsageParameterSetNameAlreadyExistsException - if the name has already been used to create a usage parameter set for the profile table.

ManagementException - if the usage parameter set could not be created due to a system-level failure.

removeUsageParameterSet

void removeUsageParameterSet(String paramSetName)
                             throws NullPointerException,
                                    UnrecognizedUsageParameterSetNameException,
                                    ManagementException

Remove an existing usage parameter set from the profile table that this MBean is providing usage management access for.

Parameters:

paramSetName - the usage parameter set name.

Throws:

NullPointerException - if paramSetName is null.

UnrecognizedUsageParameterSetNameException - if the name does not identify a usage parameter set that has been created for the profile table.

ManagementException - if the name could not be removed due to a system-level failure.

getUsageParameterSets

String[] getUsageParameterSets()
                               throws ManagementException

Get the names of the usage parameter sets that have been created for the profile table that this MBean is providing usage management access for.

Returns:

the names of the usage parameter sets.

Throws:

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

getUsageMBean

ObjectName getUsageMBean()
                         throws ManagementException

Get the JMX Object Name of a UsageMBean object that provides management access to the unnamed usage parameter set for the profile table that this MBean is providing usage management access for.

Returns:

the Object Name of a UsageMBean object for the unnamed usage parameter set for the profile table.

Throws:

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

getUsageMBean

ObjectName getUsageMBean(String paramSetName)
                         throws NullPointerException,
                                UnrecognizedUsageParameterSetNameException,
                                ManagementException

Get the JMX Object Name of a UsageMBean object that provides management access to the named usage parameter set for the profile table that this MBean is providing usage management access for.

Parameters:

paramSetName - the name of the usage parameter set. The name must be one of the names returned by getUsageParameterSets().

Returns:

the Object Name of a UsageMBean object for the named usage parameter set for the profile table.

Throws:

NullPointerException - if paramSetName is null.

UnrecognizedUsageParameterSetNameException - if the named usage parameter set has not been created for the profilet table.

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

getUsageNotificationManagerMBean

ObjectName getUsageNotificationManagerMBean()
                                            throws ManagementException

Get the JMX Object Name of a UsageNotificationManagerMBean that provides management access to the usage notification manager for the profile table that this MBean is providing usage management access for.

Throws:

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

resetAllUsageParameters

void resetAllUsageParameters()
                             throws ManagementException

Reset all usage parameters in the unamed usage parameter set, and all named usage parameter sets, of the profile table that this MBean is providing usage management access for. Counter-type usage parameters are reset to 0 and sample-type usage parameters have all samples cleared.

Throws:

ManagementException - if the values of the usage parameters could not be reset due to a system-level failure.

close

void close()
           throws ManagementException

Notify the SLEE that the Profile Table Usage MBean is no longer required by the management client. As the SLEE may subsequently deregister this MBean from the MBean server, a client that invokes this method should assume that the Object Name they had for the MBean is no longer valid once this method returns.

Throws:

ManagementException - if the Profile Table Usage MBean could not be closed by the SLEE due to a system-level failure.