Skip navigation links

Oracle Fusion Middleware
Java API Reference for Oracle WebLogic Server
12c (12.2.1)

Part Number E55141-01
P4 Change 1723563 on 2015/10/09


weblogic.management.configuration
Interface ExecuteQueueMBean

All Superinterfaces:
ConfigurationMBean, DescriptorBean, DynamicMBean, MBeanRegistration, NotificationBroadcaster, SettableBean, WebLogicMBean

public interface ExecuteQueueMBean
extends ConfigurationMBean

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


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
abstract  int getQueueLength()
          The maximum number of simultaneous requests that this server can hold in the queue.
abstract  int getQueueLengthThresholdPercent()
          The percentage of the Queue Length size that can be reached before this server indicates an overflow condition for the queue.
abstract  int getThreadCount()
          The number of threads assigned to this queue.
abstract  int getThreadsIncrease()
          Specifies the number of threads to increase the queue length when the queue length theshold is reached.
abstract  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.
abstract  void setQueueLength(int value)
          Sets the value of the QueueLength attribute.
abstract  void setQueueLengthThresholdPercent(int value)
           
abstract  void setThreadCount(int value)
          Sets the value of the ThreadCount attribute.
abstract  void setThreadPriority(int value)
          Sets the priority of the threads associated with this queue.
abstract  void setThreadsIncrease(int value)
          Sets the value of the ThreadsIncrease attribute.
abstract  void setThreadsMaximum(int value)
          Sets the value of the ThreadsMaximum attribute.
abstract  void setThreadsMinimum(int value)
          Sets the value of the ThreadsMinmum attribute.

 

Methods inherited from interface weblogic.management.configuration.ConfigurationMBean
freezeCurrentValue, getId, getInheritedProperties, getName, getNotes, isDynamicallyCreated, isInherited, isSet, restoreDefaultValue, setComments, setDefaultedMBean, setName, setNotes, setPersistenceEnabled, unSet

 

Methods inherited from interface weblogic.management.WebLogicMBean
getMBeanInfo, getObjectName, getParent, getType, isCachingDisabled, isRegistered, setParent

 

Methods inherited from interface javax.management.DynamicMBean
getAttribute, getAttributes, invoke, setAttribute, setAttributes

 

Methods inherited from interface javax.management.MBeanRegistration
postDeregister, postRegister, preDeregister, preRegister

 

Methods inherited from interface javax.management.NotificationBroadcaster
addNotificationListener, getNotificationInfo, removeNotificationListener

 

Methods inherited from interface weblogic.descriptor.DescriptorBean
addPropertyChangeListener, createChildCopyIncludingObsolete, getParentBean, isEditable, removePropertyChangeListener

 

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

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

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

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

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

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

Skip navigation links

Copyright 1996, 2015, 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
Java API Reference for Oracle WebLogic Server
12c (12.2.1)

Part Number E55141-01
P4 Change 1723563 on 2015/10/09