Oracle Fusion Middleware
Oracle WebLogic Server MBean Javadoc
11g Release 1 (10.3.6)

Part Number E13945-06

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."


Field Summary
static String DEFAULT_QUEUE_NAME
          The name of the default execute queue.
 
Fields inherited from interface weblogic.management.configuration.ConfigurationMBean
DEFAULT_EMPTY_BYTE_ARRAY
 
Method Summary
 int getQueueLength()
          The maximum number of simultaneous requests that this server can hold in the queue.
 int getQueueLengthThresholdPercent()
          The percentage of the Queue Length size that can be reached before this server indicates an overflow condition for the queue.
 int getThreadCount()
          The number of threads assigned to this queue.
 int getThreadsIncrease()
          Specifies the number of threads to increase the queue length when the queue length theshold is reached.
 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.
 void setQueueLength(int value)
          Sets the value of the QueueLength attribute.
 void setQueueLengthThresholdPercent(int value)
           
 void setThreadCount(int value)
          Sets the value of the ThreadCount attribute.
 void setThreadPriority(int value)
          Sets the priority of the threads associated with this queue.
 void setThreadsIncrease(int value)
          Sets the value of the ThreadsIncrease attribute.
 void setThreadsMaximum(int value)
          Sets the value of the ThreadsMaximum attribute.
 void setThreadsMinimum(int value)
          Sets the value of the ThreadsMinmum attribute.
 
Methods inherited from interface weblogic.management.configuration.ConfigurationMBean
freezeCurrentValue, getName, getNotes, isSet, restoreDefaultValue, setComments, setDefaultedMBean, setName, setNotes, setPersistenceEnabled, unSet
 

Field Detail

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
Method Detail

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()

Copyright 1996, 2011, Oracle and/or its affiliates. All rights reserved. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

Oracle Fusion Middleware
Oracle WebLogic Server MBean Javadoc
11g Release 1 (10.3.6)

Part Number E13945-06