weblogic.management.configuration
Interface ExecuteQueueMBean

All Superinterfaces:

ConfigurationMBean

public interface ExecuteQueueMBean
extends ConfigurationMBean

This bean is used to configure an execute queue and its associated thread pool.

Deprecation of MBeanHome and Type-Safe Interfaces

This is a type-safe interface for a WebLogic Server MBean, which you can import into your client classes and access through weblogic.management.MBeanHome. As of 9.0, the MBeanHome interface and all type-safe interfaces for WebLogic Server MBeans are deprecated. Instead, client classes that interact with WebLogic Server MBeans should use standard JMX design patterns in which clients use the javax.management.MBeanServerConnection interface to discover MBeans, attributes, and attribute types at runtime. For more information, see "Developing Manageable Applications with JMX."

DEFAULT_QUEUE_NAME

static final String DEFAULT_QUEUE_NAME

The name of the default execute queue. getName() on the ExecuteQueueMBean which represents the default execute queue will return this name.

See Also:

Constant Field Values

getQueueLength

int getQueueLength()

The maximum number of simultaneous requests that this server can hold in the queue.

Returns:

The queueLength value

Default Value:

65536

Maximum Value:

1073741824

Minimum Value:

256

setQueueLength

void setQueueLength(int value)
                    throws InvalidAttributeValueException

Sets the value of the QueueLength attribute.

Parameters:

value - The new queueLength value

Throws:

InvalidAttributeValueException

See Also:

ExecuteQueueMBean.getQueueLength()

setThreadPriority

void setThreadPriority(int value)
                       throws InvalidAttributeValueException

Sets the priority of the threads associated with this queue.

Parameters:

value - The new threadPriority value

Throws:

InvalidAttributeValueException

getThreadCount

int getThreadCount()

The number of threads assigned to this queue.

Returns:

The threadCount value

Default Value:

ServerLegalHelper.DEFAULT_THREAD_POOL_SIZE

Maximum Value:

65536

Minimum Value:

0

Default value in production mode:

ServerLegalHelper.PRODUCTION_MODE_THREAD_POOL_SIZE

setThreadCount

void setThreadCount(int value)
                    throws InvalidAttributeValueException

Sets the value of the ThreadCount attribute.

Parameters:

value - The new threadCount value

Throws:

InvalidAttributeValueException

See Also:

ExecuteQueueMBean.getThreadCount()

getQueueLengthThresholdPercent

int getQueueLengthThresholdPercent()

The percentage of the Queue Length size that can be reached before this server indicates an overflow condition for the queue. If the overflow condition is reached and the current thread count has not reached the ThreadsMaximum value, then ThreadsIncrease number of threads are added.

Returns:

The queueLengthThresholdPercent value

Default Value:

90

Maximum Value:

99

Minimum Value:

1

setQueueLengthThresholdPercent

void setQueueLengthThresholdPercent(int value)
                                    throws InvalidAttributeValueException

Parameters:

value - The new queueLengthThresholdPercent value

Throws:

InvalidAttributeValueException

getThreadsIncrease

int getThreadsIncrease()

Specifies the number of threads to increase the queue length when the queue length theshold is reached. This threshold is determined by the QueueLengthThresholdPercent value.

The following consideration applies to the dynamic nature of ThreadsMaximum and ThreadsIncrease attributes. If any of these attributes change during runtime, the changed value comes into effect when the next request is submitted to the execute queue and the scheduler decides to increase threads depending on the queue threshold conditions.

Returns:

The threadsIncrease value

Default Value:

0

Maximum Value:

65536

Minimum Value:

0

setThreadsIncrease

void setThreadsIncrease(int value)
                        throws InvalidAttributeValueException

Sets the value of the ThreadsIncrease attribute.

Parameters:

value - The new threadsIncrease value

Throws:

InvalidAttributeValueException

See Also:

ExecuteQueueMBean.getThreadsIncrease()

getThreadsMaximum

int getThreadsMaximum()

The maximum number of threads that this queue is allowed to have; this value prevents WebLogic Server from creating an overly high thread count in the queue in response to continual overflow conditions.

A note about dynamic nature of ThreadsMaximum and ThreadsIncrease attributes. If any of these attributes change during runtime, the changed value comes into effect when the next request is submitted to the execute queue and the scheduler decides to increase threads depending on the queue threshold conditions. Imagine a scenario where the queue capacity has already reached the max threshold and the current thread count is already equal to ThreadsMaximum value. If more work is coming into the queue and the administrator wishes to increase the ThreadsMaximum a little to add a few more threads, he/she can do so by changing these attributes dynamically. Please note that the changed value is evaluated when the next request is submitted.

Returns:

The threadsMaximum value

Default Value:

400

Maximum Value:

65536

Minimum Value:

1

setThreadsMaximum

void setThreadsMaximum(int value)
                       throws InvalidAttributeValueException

Sets the value of the ThreadsMaximum attribute.

Parameters:

value - The new threadsMaximum value

Throws:

InvalidAttributeValueException

See Also:

ExecuteQueueMBean.getThreadsMaximum()

setThreadsMinimum

void setThreadsMinimum(int value)
                       throws InvalidAttributeValueException

Sets the value of the ThreadsMinmum attribute.

Parameters:

value - The new threadsMinimum value

Throws:

InvalidAttributeValueException

See Also:

ExecuteQueueMBean.getThreadsMinimum()