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

Part Number E13945-06

weblogic.management.configuration
Interface KernelMBean

All Superinterfaces:
ConfigurationMBean
All Known Subinterfaces:
ServerMBean

public interface KernelMBean
extends ConfigurationMBean

This bean represents the configuration of the core message passing kernel on both WebLogic clients and servers.

ServerMBean extends this bean to represent the configuration of a server.

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.


Field Summary
static String STDOUT_NOID
          Format of messages logged to the console in WLS 6.
static String STDOUT_STANDARD
          Default format of messages logged to the console
 
Fields inherited from interface weblogic.management.configuration.ConfigurationMBean
DEFAULT_EMPTY_BYTE_ARRAY
 
Method Summary
 String getAdministrationProtocol()
          Returns the protocol to be used for administrative connections when none is specified.
 int getCompleteCOMMessageTimeout()
          Deprecated. 8.1.0.0 use NetworkAccessPointMBean.getCompleteMessageTimeout()
 int getCompleteHTTPMessageTimeout()
          Deprecated. 8.1.0.0 use NetworkAccessPointMBean.getCompleteMessageTimeout()
 int getCompleteIIOPMessageTimeout()
          Deprecated. 8.1.0.0 use NetworkAccessPointMBean.getCompleteMessageTimeout()
 int getCompleteMessageTimeout()
          The maximum number of seconds that this server waits for a complete message to be received.
 int getCompleteT3MessageTimeout()
          Deprecated. 8.1.0.0 use NetworkAccessPointMBean.getCompleteMessageTimeout()
 int getConnectTimeout()
          The amount of time that this server should wait to establish an outbound socket connection before timing out.
 String getDefaultProtocol()
          The protocol to use for connections when none is specified.
 String getDefaultSecureProtocol()
          The protocol to use for secure connections when none is specified.
 int getDGCIdlePeriodsUntilTimeout()
          The number of idle periods allowed before object is collected.
 ExecuteQueueMBean[] getExecuteQueues()
          Returns the execute queues configured for this server.
 int getIdleConnectionTimeout()
          The maximum number of seconds that a connection is allowed to be idle before it is closed by the server.
 int getIdleIIOPConnectionTimeout()
          Deprecated. 8.1.0.0 use NetworkAccessPointMBean.getIdleConnectionTimeout()
 int getIdlePeriodsUntilTimeout()
          The number of idle periods until peer is considered unreachable
 IIOPMBean getIIOP()
          Returns the kernel's IIOP configuration.
 String getIIOPTxMechanism()
          Deprecated. 8.1.0.0 use IIOPMBean.getTxMechanism()
 LogMBean getLog()
          Returns the Log settings for this Kernel.
 int getMaxCOMMessageSize()
          Deprecated. 8.1.0.0 use NetworkAccessPointMBean.getMaxMessageSize()
 int getMaxHTTPMessageSize()
          Deprecated. 8.1.0.0 use NetworkAccessPointMBean.getMaxMessageSize()
 int getMaxIIOPMessageSize()
          Deprecated. 8.1.0.0 use NetworkAccessPointMBean.getMaxMessageSize()
 int getMaxMessageSize()
          The maximum number of bytes allowed in messages that are received over all supported protocols, unless overridden by a protocol-specific setting or a custom channel setting.
 int getMaxOpenSockCount()
          The maximum number of open sockets allowed in server at a given point of time.
 int getMaxT3MessageSize()
          Deprecated. 8.1.0.0 use NetworkAccessPointMBean.getMaxMessageSize()
 int getMessagingBridgeThreadPoolSize()
          Deprecated. 9.0.0.0 replaced by a Work Manager named weblogic.jms.MessagingBridge
 String getMuxerClass()
          To enable non-blocking IO, enter weblogic.socket.NIOSocketMuxer in the Muxer Class field.
 int getPeriodLength()
          The time interval in milliseconds of the heartbeat period.
 int getSocketReaders()
          The number of socket reader threads
 SSLMBean getSSL()
          Returns the kernel's SSL configuration.
 String getStdoutFormat()
          Deprecated.  
 int getStdoutSeverityLevel()
          Deprecated. 9.0.0.0 Replaced by LogMBean.StdoutSeverity. For backward compatibility the changes to this attribute will be propagated to the LogMBean.
 int getStuckThreadMaxTime()
          Deprecated. 9.0.0.0 replaced by ServerFailureTriggerMBean.getMaxStuckThreadTime()
 int getStuckThreadTimerInterval()
          The number of seconds after which WebLogic Server periodically scans threads to see if they have been continually working for the configured maximum length of time.
 int getThreadPoolPercentSocketReaders()
          The percentage of execute threads from the default queue that can be used as socket readers.
 boolean getUse81StyleExecuteQueues()
          Backward compatibility mode to switch to 8.1 execute queues instead of WorkManagers.
 boolean isAddWorkManagerThreadsByCpuCount()
          Enables increased efficiency of the self-tuning thread pool by aligning it with the Exalogic processor architecture threading capabilities.
 boolean isGatheredWritesEnabled()
          Enables gathered writes over NIO socket channels.
 boolean isInstrumentStackTraceEnabled()
          Specifies whether the server returns stack traces for RMI calls that generate exceptions.
 boolean isLogRemoteExceptionsEnabled()
          Specifies whether the server message log includes exceptions that are raised in remote systems.
 boolean isNativeIOEnabled()
          Specifies whether native I/O is enabled for the server.
 boolean isOutboundEnabled()
          Specifies whether new server-to-server connections may consider the default server channel when initiating a connection.
 boolean isOutboundPrivateKeyEnabled()
          Specifies whether the SSL identity specified by SSLMBean#ServerPrivateKeyAlias for this server should be used for outbound SSL connections on the default server channel.
 boolean isReverseDNSAllowed()
          Specifies whether the kernel is allowed to perform reverse DNS lookups.
 boolean isScatteredReadsEnabled()
          Enables scattered reads over NIO socket channels.
 boolean isSocketBufferSizeAsChunkSize()
          Specifies whether the server's buffer size for sending or receiving data through a raw socket should be set to 4KB.
 boolean isStdoutDebugEnabled()
          Deprecated. 9.0.0.0 replaced by LogMBean.StdoutSeverity For backward compatibility the changes to this attribute will be propagated to the LogMBean.
 boolean isStdoutEnabled()
          Deprecated. 9.0.0.0 replaced by LogMBean.StdoutSeverity, for backward compatibility the changes to this attribute will be propagated to the LogMBean.
 boolean isStdoutLogStack()
          Deprecated. 9.0.0.0
 boolean isUseConcurrentQueueForRequestManager()
          Reduces lock contention by using concurrent buffer queue to park incoming requests.
 ExecuteQueueMBean lookupExecuteQueue(String name)
           
 void setAddWorkManagerThreadsByCpuCount(boolean flag)
          Specifies whether self-tuning thread pool should increment thread count by CPU count
 void setAdministrationProtocol(String protocol)
          Sets the protocol to be used for ADMIN connections when none is specified.
 void setCompleteCOMMessageTimeout(int seconds)
          Sets the value of the CompleteCOMMessageTimeout attribute.
 void setCompleteHTTPMessageTimeout(int seconds)
          Sets the value of the CompleteHTTPMessageTimeout attribute.
 void setCompleteIIOPMessageTimeout(int seconds)
          Sets the value of the CompleteIIOPMessageTimeout attribute.
 void setCompleteMessageTimeout(int seconds)
          Sets the value of the CompleteMessageTimeout attribute.
 void setCompleteT3MessageTimeout(int seconds)
          Sets the value of the CompleteT3MessageTimeout attribute.
 void setConnectTimeout(int timeout)
          Sets the value of the ConnectTimeout attribute.
 void setDefaultProtocol(String protocol)
          Sets the value of the DefaultProtocol attribute.
 void setDefaultSecureProtocol(String protocol)
          Sets the value of the DefaultSecureProtocol attribute.
 void setDGCIdlePeriodsUntilTimeout(int periods)
          Sets the value of the DGCIdlePeriodsUntilTimeout attribute.
 void setGatheredWritesEnabled(boolean enable)
          Enables gathered writes over NIO Socket channels.
 void setIdleConnectionTimeout(int seconds)
          Sets the value of the IdleConnectionTimeout attribute.
 void setIdleIIOPConnectionTimeout(int seconds)
          Sets the value of the IdleIIOPConnectionTimeout attribute.
 void setIdlePeriodsUntilTimeout(int idlePeriods)
          Sets the value of the IdlePeriodsUntilTimeout attribute.
 void setIIOPTxMechanism(String mech)
          Sets the iIOPTxMechanism attribute of the KernelMBean object
 void setInstrumentStackTraceEnabled(boolean enable)
          Sets the value of the InstrumentStackTraceEnabled attribute.
 void setLogRemoteExceptionsEnabled(boolean enable)
          Sets the value of the LogRemoteExceptionsEnabled attribute.
 void setMaxCOMMessageSize(int maxsize)
          Sets the value of the MaxCOMMessageSize attribute.
 void setMaxHTTPMessageSize(int maxsize)
          Sets the value of the MaxHTTPMessageSize attribute.
 void setMaxIIOPMessageSize(int maxsize)
          Deprecated.  
 void setMaxMessageSize(int maxsize)
          Sets the value of the MaxMessageSize attribute.
 void setMaxOpenSockCount(int sockCount)
          Sets the value of the MaxOpenSockCount attribute.
 void setMaxT3MessageSize(int maxsize)
          Sets the value of the MaxT3MessageSize attribute.
 void setMessagingBridgeThreadPoolSize(int size)
          Sets the value of the MessagingBridgeThreadPoolSize attribute.
 void setMuxerClass(String name)
          Sets the value of the MuxerClass attribute.
 void setNativeIOEnabled(boolean enable)
          Sets the value of the NativeIOEnabled attribute.
 void setOutboundEnabled(boolean enabled)
          Sets the value of the OutboundEnabled attribute.
 void setOutboundPrivateKeyEnabled(boolean enabled)
          Sets the value of the OutboundPrivateKeyEnabled attribute.
 void setPeriodLength(int periodLength)
          Sets the value of the PeriodLength attribute.
 void setReverseDNSAllowed(boolean flag)
          Sets the value of the ReverseDNSAllowed attribute.
 void setScatteredReadsEnabled(boolean enable)
          Enables scattered reads over NIO Socket channels.Applicable only for NIO socketMuxer
 void setSocketBufferSizeAsChunkSize(boolean flag)
          Sets the value of the SocketBuffersSizeAsChunkSize attribute.
 void setSocketReaders(int numReaders)
          Sets the value of the SocketReaders attribute.
 void setStdoutDebugEnabled(boolean enable)
          Sets the value of the StdoutDebugEnabled attribute.
 void setStdoutEnabled(boolean enable)
          Deprecated.  
 void setStdoutFormat(String format)
          Deprecated.  
 void setStdoutLogStack(boolean stack)
          Deprecated. 9.0.0.0
 void setStdoutSeverityLevel(int severityLevel)
          Sets the value of the StdoutSeverityLevel attribute.
 void setStuckThreadMaxTime(int seconds)
          Deprecated. 9.0.0.0 replaced by ServerFailureTriggerMBean.setMaxStuckThreadTime()
 void setStuckThreadTimerInterval(int seconds)
          Sets the value of the StuckThreadTimerInterval attribute.
 void setThreadPoolPercentSocketReaders(int percent)
          Sets the value of the ThreadPoolPercentSocketReaders attribute.
 void setUse81StyleExecuteQueues(boolean enable)
          Backward compatibility mode to switch to 8.1 execute queues instead of WorkManagers.
 void setUseConcurrentQueueForRequestManager(boolean flag)
          Specifies if self-tuning should use buffer queue to park incoming requests
 
Methods inherited from interface weblogic.management.configuration.ConfigurationMBean
freezeCurrentValue, getName, getNotes, isSet, restoreDefaultValue, setComments, setDefaultedMBean, setName, setNotes, setPersistenceEnabled, unSet
 

Field Detail

STDOUT_STANDARD

static final String STDOUT_STANDARD
Default format of messages logged to the console

See Also:
Constant Field Values

STDOUT_NOID

static final String STDOUT_NOID
Format of messages logged to the console in WLS 6. Does not include message id in output.

See Also:
Constant Field Values
Method Detail

isReverseDNSAllowed

boolean isReverseDNSAllowed()

Specifies whether the kernel is allowed to perform reverse DNS lookups.

Returns:
The reverseDNSAllowed value
Default Value:
false

setReverseDNSAllowed

void setReverseDNSAllowed(boolean flag)
                          throws DistributedManagementException

Sets the value of the ReverseDNSAllowed attribute.

Parameters:
flag - The new reverseDNSAllowed value
Throws:
DistributedManagementException
See Also:
KernelMBean.isReverseDNSAllowed()
Default Value:
false

getDefaultProtocol

String getDefaultProtocol()

The protocol to use for connections when none is specified.

Returns:
The defaultProtocol value
Default Value:
"t3"
Valid Values:
"t3","t3s","http","https","iiop","iiops"

setDefaultProtocol

void setDefaultProtocol(String protocol)
                        throws InvalidAttributeValueException,
                               DistributedManagementException

Sets the value of the DefaultProtocol attribute.

Parameters:
protocol - The new defaultProtocol value
Throws:
InvalidAttributeValueException
DistributedManagementException
IllegalArgumentException - if the protocol is not supported by this kernel.
See Also:
KernelMBean.getDefaultProtocol()

getDefaultSecureProtocol

String getDefaultSecureProtocol()

The protocol to use for secure connections when none is specified.

Returns:
The defaultSecureProtocol value
Default Value:
"t3s"
Valid Values:
"t3s","https","iiops"

setDefaultSecureProtocol

void setDefaultSecureProtocol(String protocol)
                              throws InvalidAttributeValueException,
                                     DistributedManagementException

Sets the value of the DefaultSecureProtocol attribute.

Parameters:
protocol - The new defaultSecureProtocol value
Throws:
InvalidAttributeValueException
DistributedManagementException
IllegalArgumentException - if the protocol is not supported by this kernel.
See Also:
KernelMBean.getDefaultSecureProtocol()

getAdministrationProtocol

String getAdministrationProtocol()

Returns the protocol to be used for administrative connections when none is specified.

Returns:
The administrationProtocol value
Valid Values:
"t3s","https","iiops","t3","http","iiop"

setAdministrationProtocol

void setAdministrationProtocol(String protocol)
                               throws InvalidAttributeValueException,
                                      DistributedManagementException

Sets the protocol to be used for ADMIN connections when none is specified.

Parameters:
protocol - The new administrationProtocol value
Throws:
InvalidAttributeValueException
DistributedManagementException

isNativeIOEnabled

boolean isNativeIOEnabled()

Specifies whether native I/O is enabled for the server.

Returns:
The nativeIOEnabled value
See Also:
KernelMBean.getSocketReaderTimeoutMaxMillis()
Default Value:
true

setNativeIOEnabled

void setNativeIOEnabled(boolean enable)

Sets the value of the NativeIOEnabled attribute.

Parameters:
enable - The new nativeIOEnabled value
See Also:
KernelMBean.isNativeIOEnabled()

getMuxerClass

String getMuxerClass()

To enable non-blocking IO, enter weblogic.socket.NIOSocketMuxer in the Muxer Class field.

The default value is null (not enabled). However, if ExalogicOptimizationsEnabled is true, the value is reset to weblogic.socket.NIOSocketMuxer.

The Certicom SSL implementation is not supported with NIOSocketMuxer. If you need to secure internet communication, Oracle recommends implementing JSSE (Java Secure Socket Extension).

Returns:
The muxerClass value

setMuxerClass

void setMuxerClass(String name)

Sets the value of the MuxerClass attribute.

Parameters:
name - The new muxerClass value
See Also:
KernelMBean.getMuxerClass()

getSocketReaders

int getSocketReaders()

The number of socket reader threads

Returns:
The number of socket reader threads

setSocketReaders

void setSocketReaders(int numReaders)

Sets the value of the SocketReaders attribute.

Parameters:
numReaders - The number of socket reader threads
See Also:
KernelMBean.getSocketReaders()
Default Value:
-1
Maximum Value:
65534
Minimum Value:
-1

getThreadPoolPercentSocketReaders

int getThreadPoolPercentSocketReaders()

The percentage of execute threads from the default queue that can be used as socket readers.

Returns:
The threadPoolPercentSocketReaders value
Default Value:
33

setThreadPoolPercentSocketReaders

void setThreadPoolPercentSocketReaders(int percent)
                                       throws InvalidAttributeValueException,
                                              DistributedManagementException

Sets the value of the ThreadPoolPercentSocketReaders attribute.

Parameters:
percent - The new threadPoolPercentSocketReaders value
Throws:
InvalidAttributeValueException
DistributedManagementException
IllegalArgumentException - if the argument is null or represents a negative int.
See Also:
KernelMBean.getThreadPoolPercentSocketReaders()
Maximum Value:
99
Minimum Value:
1

isOutboundEnabled

boolean isOutboundEnabled()

Specifies whether new server-to-server connections may consider the default server channel when initiating a connection. This is only relevant if the connection needs to be bound to the default listen address. This will only work for binary protocols that support both outbound and inbound traffic.

When this feature is not enabled, connections are initiated using a local address selected by the underlying hardware. For the default channel this is usually what is wanted for IP-routing to be effective. Note that since the default is false, other outbound channels will be considered in preference to the default channel.

Default administration channels, created when the domain-wide administration port is turned on, are always considered and bound when initiating an administrative connection. To allow IP-routing for administration traffic create custom admin with isOutboundEnabled set to false instead of enabling the domain-wide ADMIN port.

Returns:
The outboundEnabled value
See Also:
NetworkAccessPointMBean.isOutboundEnabled()
Default Value:
false

setOutboundEnabled

void setOutboundEnabled(boolean enabled)
                        throws InvalidAttributeValueException

Sets the value of the OutboundEnabled attribute.

Parameters:
enabled - The new outboundEnabled value
Throws:
InvalidAttributeValueException
See Also:
KernelMBean.isOutboundEnabled()

isOutboundPrivateKeyEnabled

boolean isOutboundPrivateKeyEnabled()

Specifies whether the SSL identity specified by SSLMBean#ServerPrivateKeyAlias for this server should be used for outbound SSL connections on the default server channel. In normal circumstances the outbound identity is determined by the caller's environment.

Returns:
The OutboundPrivateKeyEnabled value
See Also:
KernelMBean.isOutboundEnabled()
Default Value:
false

setOutboundPrivateKeyEnabled

void setOutboundPrivateKeyEnabled(boolean enabled)
                                  throws InvalidAttributeValueException

Sets the value of the OutboundPrivateKeyEnabled attribute.

Parameters:
enabled - The new outboundEnabled value
Throws:
InvalidAttributeValueException
See Also:
KernelMBean.isOutboundPrivateKeyEnabled()

getMaxMessageSize

int getMaxMessageSize()

The maximum number of bytes allowed in messages that are received over all supported protocols, unless overridden by a protocol-specific setting or a custom channel setting.

The order of precedence for setting message size maximums is as follows:

  1. A channel-wide maximum in a custom network channel.

  2. A protocol-specific setting in the default network channel.
    See

    • MaxCOMMessageSize
    • MaxHTTPMessageSize
    • MaxIIOPessageSize
    • MaxT3MessageSize

  3. The message maximum in this attribute.

This maximum message size helps guard against a denial of service attack in which a caller attempts to force the server to allocate more memory than is available thereby keeping the server from responding quickly to other requests.

Returns:
The maxMessageSize value
See Also:
NetworkAccessPointMBean
Default Value:
10000000
Maximum Value:
2000000000
Minimum Value:
4096

setMaxMessageSize

void setMaxMessageSize(int maxsize)
                       throws InvalidAttributeValueException,
                              DistributedManagementException

Sets the value of the MaxMessageSize attribute.

Parameters:
maxsize - The new maxMessageSize value
Throws:
InvalidAttributeValueException
DistributedManagementException
See Also:
KernelMBean.getMaxMessageSize()

getMaxT3MessageSize

int getMaxT3MessageSize()
Deprecated. 8.1.0.0 use NetworkAccessPointMBean.getMaxMessageSize()

The maximum number of bytes allowed in messages that are received over the T3 protocol. If you configure custom network channels for this server, each channel can override this maximum message size.

This maximum message size helps guard against a denial of service attack in which a caller attempts to force the server to allocate more memory than is available thereby keeping the server from responding quickly to other requests.

A value of -1 causes the T3 protocol to use the maximums that are specified elsewhere along the order of precedence.

Returns:
The maxT3MessageSize value
See Also:
KernelMBean.getMaxMessageSize(), NetworkAccessPointMBean.getMaxMessageSize()
Default Value:
-1

setMaxT3MessageSize

void setMaxT3MessageSize(int maxsize)
                         throws InvalidAttributeValueException,
                                DistributedManagementException

Sets the value of the MaxT3MessageSize attribute.

Parameters:
maxsize - The new maxT3MessageSize value
Throws:
InvalidAttributeValueException
DistributedManagementException
See Also:
#tgetMaxT3MessageSize

setSocketBufferSizeAsChunkSize

void setSocketBufferSizeAsChunkSize(boolean flag)
                                    throws DistributedManagementException

Sets the value of the SocketBuffersSizeAsChunkSize attribute.

Parameters:
flag - The new SocketBufferSizeToChunkSize value
Throws:
DistributedManagementException
See Also:
KernelMBean.isSocketBufferSizeAsChunkSize()

isSocketBufferSizeAsChunkSize

boolean isSocketBufferSizeAsChunkSize()

Specifies whether the server's buffer size for sending or receiving data through a raw socket should be set to 4KB.

Otherwise, the server does not impose a limit to the buffer size and defers to the operating system. This option is useful only on some operating systems for improving performance. It should be disabled in most environments.

Returns:
The SocketBufferSizeAsChunkSize value
Default Value:
false

getMaxHTTPMessageSize

int getMaxHTTPMessageSize()
Deprecated. 8.1.0.0 use NetworkAccessPointMBean.getMaxMessageSize()

The maximum number of bytes allowed in messages that are received over the HTTP protocol. If you configure custom network channels for this server, each channel can override this maximum message size.

This maximum message size helps guard against a denial of service attack in which a caller attempts to force the server to allocate more memory than is available thereby keeping the server from responding quickly to other requests.

A value of -1 causes the HTTP protocol to use the maximums that are specified elsewhere along the order of precedence.

Returns:
The maxHTTPMessageSize value
See Also:
KernelMBean.getMaxMessageSize(), NetworkAccessPointMBean.getMaxMessageSize()
Default Value:
-1

setMaxHTTPMessageSize

void setMaxHTTPMessageSize(int maxsize)
                           throws InvalidAttributeValueException,
                                  DistributedManagementException

Sets the value of the MaxHTTPMessageSize attribute.

Parameters:
maxsize - The new maxHTTPMessageSize value
Throws:
InvalidAttributeValueException
DistributedManagementException
See Also:
KernelMBean.getMaxHTTPMessageSize()

getMaxCOMMessageSize

int getMaxCOMMessageSize()
Deprecated. 8.1.0.0 use NetworkAccessPointMBean.getMaxMessageSize()

The maximum number of bytes allowed in messages that are received over the COM protocol. If you configure custom network channels for this server, each channel can override this maximum message size.

This maximum message size helps guard against a denial of service attack in which a caller attempts to force the server to allocate more memory than is available thereby keeping the server from responding quickly to other requests.

A value of -1 causes the COM protocol to use the maximums that are specified elsewhere along the order of precedence.

Returns:
The maxCOMMessageSize value
Since:
7.0.0.0
See Also:
KernelMBean.getMaxMessageSize(), NetworkAccessPointMBean.getMaxMessageSize()
Default Value:
-1

setMaxCOMMessageSize

void setMaxCOMMessageSize(int maxsize)
                          throws InvalidAttributeValueException,
                                 DistributedManagementException

Sets the value of the MaxCOMMessageSize attribute.

Parameters:
maxsize - The new maxCOMMessageSize value
Throws:
InvalidAttributeValueException
DistributedManagementException
See Also:
KernelMBean.getMaxCOMMessageSize()

getMaxIIOPMessageSize

int getMaxIIOPMessageSize()
Deprecated. 8.1.0.0 use NetworkAccessPointMBean.getMaxMessageSize()

The maximum number of bytes allowed in messages that are received over the IIOP protocol. If you configure custom network channels for this server, each channel can override this maximum message size.

This maximum message size helps guard against a denial of service attack in which a caller attempts to force the server to allocate more memory than is available thereby keeping the server from responding quickly to other requests.

A value of -1 causes the IIOP protocol to use the maximums that are specified elsewhere along the order of precedence.

Returns:
The maxIIOPMessageSize value
See Also:
KernelMBean.getMaxMessageSize(), NetworkAccessPointMBean.getMaxMessageSize()
Default Value:
-1

setMaxIIOPMessageSize

void setMaxIIOPMessageSize(int maxsize)
                           throws InvalidAttributeValueException,
                                  DistributedManagementException
Deprecated. 

Sets the value of the MaxIIOPMessageSize attribute.

Parameters:
maxsize - The new maxIIOPMessageSize value
Throws:
InvalidAttributeValueException
DistributedManagementException
See Also:
KernelMBean.getMaxIIOPMessageSize()

getIIOPTxMechanism

String getIIOPTxMechanism()
Deprecated. 8.1.0.0 use IIOPMBean.getTxMechanism()

Configures IIOP propagate transactions using either WebLogic-specific JTA or the OMG-specified OTS.

It is not possible to use both because it affects the way transactions are negotiated.

Returns:
The iIOPTxMechanism value
Default Value:
"ots"
Valid Values:
"ots","jta"

setIIOPTxMechanism

void setIIOPTxMechanism(String mech)
                        throws InvalidAttributeValueException,
                               DistributedManagementException

Sets the iIOPTxMechanism attribute of the KernelMBean object

Parameters:
mech - The new iIOPTxMechanism value
Throws:
InvalidAttributeValueException
DistributedManagementException

getConnectTimeout

int getConnectTimeout()

The amount of time that this server should wait to establish an outbound socket connection before timing out. A value of 0 disables server connect timeout.

Returns:
The connectTimeout value
See Also:
NetworkAccessPointMBean.getConnectTimeout()
Default Value:
0
Maximum Value:
240
Minimum Value:
0

setConnectTimeout

void setConnectTimeout(int timeout)
                       throws InvalidAttributeValueException,
                              DistributedManagementException

Sets the value of the ConnectTimeout attribute.

Parameters:
timeout - The new connectTimeout value
Throws:
InvalidAttributeValueException
DistributedManagementException

getCompleteMessageTimeout

int getCompleteMessageTimeout()

The maximum number of seconds that this server waits for a complete message to be received. If you configure network channels for this server, each channel can override this message timeout.

This timeout helps guard against a denial of service attack in which a caller indicates that it will be sending a message of a certain size which it never finishes sending.

CompleteMessageTimeout affects the HTTP Response, such that if WebLogic Server discovers sockets inactive for longer than the CompleteMessageTimeout, the server will close these sockets.

Returns:
The completeMessageTimeout value
See Also:
NetworkAccessPointMBean.getCompleteMessageTimeout()
Default Value:
60
Maximum Value:
480
Minimum Value:
0

setCompleteMessageTimeout

void setCompleteMessageTimeout(int seconds)
                               throws InvalidAttributeValueException,
                                      DistributedManagementException

Sets the value of the CompleteMessageTimeout attribute.

Parameters:
seconds - The new completeMessageTimeout value
Throws:
InvalidAttributeValueException
DistributedManagementException
See Also:
KernelMBean.getCompleteMessageTimeout()

getCompleteT3MessageTimeout

int getCompleteT3MessageTimeout()
Deprecated. 8.1.0.0 use NetworkAccessPointMBean.getCompleteMessageTimeout()

The maximum number of seconds spent waiting for a complete T3 message to be received. If you configure network channels for this server, each channel can override this T3 message timeout.

This timeout helps guard against a denial of service attack in which a caller indicates that it will be sending a message of a certain size which it never finishes sending.

Returns:
The completeT3MessageTimeout value
See Also:
NetworkAccessPointMBean.getCompleteMessageTimeout()
Default Value:
-1
Maximum Value:
480
Minimum Value:
-1

setCompleteT3MessageTimeout

void setCompleteT3MessageTimeout(int seconds)
                                 throws InvalidAttributeValueException,
                                        DistributedManagementException

Sets the value of the CompleteT3MessageTimeout attribute.

Parameters:
seconds - The new completeT3MessageTimeout value
Throws:
InvalidAttributeValueException
DistributedManagementException
See Also:
KernelMBean.getCompleteT3MessageTimeout()

getCompleteHTTPMessageTimeout

int getCompleteHTTPMessageTimeout()
Deprecated. 8.1.0.0 use NetworkAccessPointMBean.getCompleteMessageTimeout()

The maximum number of seconds spent waiting for a complete HTTP message to be received. If you configure network channels for this server, each channel can override this HTTP message timeout.

This timeout helps guard against a denial of service attack in which a caller indicates that it will be sending a message of a certain size which it never finishes sending.

A value of -1 indicates that this value should be obtained from network channels configured for this server.

Returns:
The completeHTTPMessageTimeout value
See Also:
NetworkAccessPointMBean.getCompleteMessageTimeout()
Default Value:
-1
Maximum Value:
480
Minimum Value:
-1

setCompleteHTTPMessageTimeout

void setCompleteHTTPMessageTimeout(int seconds)
                                   throws InvalidAttributeValueException,
                                          DistributedManagementException

Sets the value of the CompleteHTTPMessageTimeout attribute.

Parameters:
seconds - The new completeHTTPMessageTimeout value
Throws:
InvalidAttributeValueException
DistributedManagementException
See Also:
KernelMBean.getCompleteHTTPMessageTimeout()

getCompleteCOMMessageTimeout

int getCompleteCOMMessageTimeout()
Deprecated. 8.1.0.0 use NetworkAccessPointMBean.getCompleteMessageTimeout()

The maximum number of seconds spent waiting for a complete COM message to be received. This setting does not apply to any network channels that you have configured for this server.

This timeout helps guard against a denial of service attack in which a caller indicates that they will be sending a message of a certain size which they never finish sending.

Returns:
The completeCOMMessageTimeout value
Since:
7.0.0.0
See Also:
NetworkAccessPointMBean.getCompleteMessageTimeout()
Default Value:
-1
Maximum Value:
480
Minimum Value:
-1

setCompleteCOMMessageTimeout

void setCompleteCOMMessageTimeout(int seconds)
                                  throws InvalidAttributeValueException,
                                         DistributedManagementException

Sets the value of the CompleteCOMMessageTimeout attribute.

Parameters:
seconds - The new completeCOMMessageTimeout value
Throws:
InvalidAttributeValueException
DistributedManagementException
See Also:
KernelMBean.getCompleteCOMMessageTimeout()

getIdleConnectionTimeout

int getIdleConnectionTimeout()

The maximum number of seconds that a connection is allowed to be idle before it is closed by the server. The T3 and T3S protocols ignore this attribute. If you configure network channels for this server, each channel can override this idle connection message timeout.

This timeout helps guard against server deadlock through too many open connections.

Returns:
The idleConnectionTimeout value
See Also:
NetworkAccessPointMBean.getIdleConnectionTimeout()
Default Value:
65
Minimum Value:
0

setIdleConnectionTimeout

void setIdleConnectionTimeout(int seconds)
                              throws InvalidAttributeValueException,
                                     DistributedManagementException

Sets the value of the IdleConnectionTimeout attribute.

Parameters:
seconds - The new idleConnectionTimeout value
Throws:
InvalidAttributeValueException
DistributedManagementException

getIdleIIOPConnectionTimeout

int getIdleIIOPConnectionTimeout()
Deprecated. 8.1.0.0 use NetworkAccessPointMBean.getIdleConnectionTimeout()

The maximum number of seconds an IIOP connection is allowed to be idle before it is closed by the server. This timeout helps guard against server deadlock through too many open connections.

Returns:
The idleIIOPConnectionTimeout value
Default Value:
-1
Minimum Value:
-1

setIdleIIOPConnectionTimeout

void setIdleIIOPConnectionTimeout(int seconds)
                                  throws InvalidAttributeValueException,
                                         DistributedManagementException

Sets the value of the IdleIIOPConnectionTimeout attribute.

Parameters:
seconds - The new idleIIOPConnectionTimeout value
Throws:
InvalidAttributeValueException
DistributedManagementException
See Also:
KernelMBean.getIdleIIOPConnectionTimeout()

getCompleteIIOPMessageTimeout

int getCompleteIIOPMessageTimeout()
Deprecated. 8.1.0.0 use NetworkAccessPointMBean.getCompleteMessageTimeout()

The maximum number of seconds spent waiting for a complete IIOP message to be received. This timeout helps guard against denial of service attacks in which a caller indicates that they will be sending a message of a certain size which they never finish sending.

Returns:
The completeIIOPMessageTimeout value
Default Value:
-1
Maximum Value:
480
Minimum Value:
-1

setCompleteIIOPMessageTimeout

void setCompleteIIOPMessageTimeout(int seconds)
                                   throws InvalidAttributeValueException,
                                          DistributedManagementException

Sets the value of the CompleteIIOPMessageTimeout attribute.

Parameters:
seconds - The new completeIIOPMessageTimeout value
Throws:
InvalidAttributeValueException
DistributedManagementException
See Also:
KernelMBean.getCompleteIIOPMessageTimeout()

getPeriodLength

int getPeriodLength()

The time interval in milliseconds of the heartbeat period. A value of 0 indicates that heartbeats are turned off.

Returns:
The periodLength value
Default Value:
60000

setPeriodLength

void setPeriodLength(int periodLength)
                     throws InvalidAttributeValueException

Sets the value of the PeriodLength attribute.

Parameters:
periodLength - The new periodLength value
Throws:
InvalidAttributeValueException
IllegalArgumentException - if the argument is null or represents a negative int.
See Also:
KernelMBean.getPeriodLength()
Minimum Value:
0

getIdlePeriodsUntilTimeout

int getIdlePeriodsUntilTimeout()

The number of idle periods until peer is considered unreachable

Returns:
The idlePeriodsUntilTimeout value
Default Value:
4

setIdlePeriodsUntilTimeout

void setIdlePeriodsUntilTimeout(int idlePeriods)
                                throws InvalidAttributeValueException

Sets the value of the IdlePeriodsUntilTimeout attribute.

Parameters:
idlePeriods - The new idlePeriodsUntilTimeout value
Throws:
InvalidAttributeValueException
IllegalArgumentException - if the argument is null or represents a negative int.
See Also:
KernelMBean.getIdlePeriodsUntilTimeout()
Maximum Value:
65534
Minimum Value:
4

getDGCIdlePeriodsUntilTimeout

int getDGCIdlePeriodsUntilTimeout()

The number of idle periods allowed before object is collected.

Returns:
The dGCIdlePeriodsUntilTimeout value
Default Value:
5

setDGCIdlePeriodsUntilTimeout

void setDGCIdlePeriodsUntilTimeout(int periods)
                                   throws ConfigurationException

Sets the value of the DGCIdlePeriodsUntilTimeout attribute.

Parameters:
periods - The new dGCIdlePeriodsUntilTimeout value
Throws:
ConfigurationException
See Also:
KernelMBean.getDGCIdlePeriodsUntilTimeout()

getSSL

SSLMBean getSSL()

Returns the kernel's SSL configuration. An SSL MBean is always linked to a particular Kernel and cannot be changed. Individual attributes on the SSL MBean may be changed, as documented, but the MBean itself may not.

Returns:
The sSL value

getIIOP

IIOPMBean getIIOP()

Returns the kernel's IIOP configuration. An IIOP MBean is always linked to a particular Kernel and cannot be changed. Individual attributes on the IIOP MBean may be changed, as documented, but the MBean itself may not.

Returns:
The iIOP value

getLog

LogMBean getLog()

Returns the Log settings for this Kernel. An Log MBean is always linked to a particular Kernel and cannot be changed. Individual attributes on the Log MBean may be changed, as documented, but the MBean itself may not.

Returns:
The log value

isStdoutEnabled

boolean isStdoutEnabled()
Deprecated. 9.0.0.0 replaced by LogMBean.StdoutSeverity, for backward compatibility the changes to this attribute will be propagated to the LogMBean.

Specifies whether the server sends messages to standard out in addition to the log file.

Other settings configure the minimum severity of a message that the server sends to standard out.

Returns:
The stdoutEnabled value
See Also:
KernelMBean.isStdoutDebugEnabled(), KernelMBean.getStdoutSeverityLevel()
Default Value:
true

setStdoutEnabled

void setStdoutEnabled(boolean enable)
                      throws DistributedManagementException
Deprecated. 

Sets the value of the StdoutEnabled attribute.

Parameters:
enable - The new stdoutEnabled value
Throws:
DistributedManagementException
See Also:
KernelMBean.isStdoutEnabled()

getStdoutSeverityLevel

int getStdoutSeverityLevel()
Deprecated. 9.0.0.0 Replaced by LogMBean.StdoutSeverity. For backward compatibility the changes to this attribute will be propagated to the LogMBean.

The minimum severity of a message that the server sends to standard out. (Requires you to enable sending messages to standard out.)

Returns:
The stdoutSeverityLevel value
See Also:
KernelMBean.isStdoutEnabled()
Default Value:
weblogic.logging.Severities.NOTICE
Valid Values:
weblogic.logging.Severities.TRACE,weblogic.logging.Severities.DEBUG,weblogic.logging.Severities.INFO,weblogic.logging.Severities.WARNING,weblogic.logging.Severities.ERROR,weblogic.logging.Severities.NOTICE,weblogic.logging.Severities.CRITICAL,weblogic.logging.Severities.ALERT,weblogic.logging.Severities.EMERGENCY,weblogic.logging.Severities.OFF

setStdoutSeverityLevel

void setStdoutSeverityLevel(int severityLevel)
                            throws InvalidAttributeValueException,
                                   DistributedManagementException

Sets the value of the StdoutSeverityLevel attribute.

Parameters:
severityLevel - The new stdoutSeverityLevel value
Throws:
InvalidAttributeValueException
DistributedManagementException
See Also:
KernelMBean.getStdoutSeverityLevel()

isStdoutDebugEnabled

boolean isStdoutDebugEnabled()
Deprecated. 9.0.0.0 replaced by LogMBean.StdoutSeverity For backward compatibility the changes to this attribute will be propagated to the LogMBean.

Specifies whether the server sends messages of the DEBUG severity to standard out in addition to the log file. (Requires you to enable sending messages to standard out.)

Returns:
The stdoutDebugEnabled value
Default Value:
false

setStdoutDebugEnabled

void setStdoutDebugEnabled(boolean enable)
                           throws DistributedManagementException

Sets the value of the StdoutDebugEnabled attribute.

Parameters:
enable - The new stdoutDebugEnabled value
Throws:
DistributedManagementException
See Also:
KernelMBean.isStdoutDebugEnabled()

isLogRemoteExceptionsEnabled

boolean isLogRemoteExceptionsEnabled()

Specifies whether the server message log includes exceptions that are raised in remote systems.

Returns:
The logRemoteExceptionsEnabled value
Default Value:
false

setLogRemoteExceptionsEnabled

void setLogRemoteExceptionsEnabled(boolean enable)
                                   throws DistributedManagementException

Sets the value of the LogRemoteExceptionsEnabled attribute.

Parameters:
enable - The new logRemoteExceptionsEnabled value
Throws:
DistributedManagementException
See Also:
KernelMBean.isLogRemoteExceptionsEnabled()

isInstrumentStackTraceEnabled

boolean isInstrumentStackTraceEnabled()

Specifies whether the server returns stack traces for RMI calls that generate exceptions.

With RMI stack tracking enabled, if a client issues an RMI call to a server subsystem or to a module running within the server, and if the subsystem or module generates an exception that includes a stack trace, the server will return the exception as well as the stack trace. With it disabled, the server will return the exception without the stack trace details.

Returns:
The instrumentStackTraceEnabled value
Default Value:
true

setInstrumentStackTraceEnabled

void setInstrumentStackTraceEnabled(boolean enable)
                                    throws DistributedManagementException

Sets the value of the InstrumentStackTraceEnabled attribute.

Parameters:
enable - The new instrumentStackTraceEnabled value
Throws:
DistributedManagementException
See Also:
KernelMBean.isInstrumentStackTraceEnabled()

getExecuteQueues

ExecuteQueueMBean[] getExecuteQueues()

Returns the execute queues configured for this server.

Returns:
The executeQueues value

getMaxOpenSockCount

int getMaxOpenSockCount()

The maximum number of open sockets allowed in server at a given point of time.

When the maximum threshold is reached, the server stops accepting new requests until the number of sockets drops below the threshold.

A value less than 0 indicates an unlimited size.

Returns:
The maxOpenSockCount value
Default Value:
-1
Maximum Value:
java.lang.Integer.MAX_VALUE
Minimum Value:
-1

setMaxOpenSockCount

void setMaxOpenSockCount(int sockCount)

Sets the value of the MaxOpenSockCount attribute.

Parameters:
sockCount - The new maxOpenSockCount value
See Also:
#tgetMaxOpenSockCount
Default Value:
-1
Maximum Value:
java.lang.Integer.MAX_VALUE
Minimum Value:
-1

getStdoutFormat

String getStdoutFormat()
Deprecated. 

The output format to use when logging to the console.

Returns:
The stdoutFormat value
Default Value:
KernelMBean.STDOUT_STANDARD
Valid Values:
KernelMBean.STDOUT_STANDARD,KernelMBean.STDOUT_NOID

setStdoutFormat

void setStdoutFormat(String format)
Deprecated. 

Sets the value of the StdoutFormat attribute.

Parameters:
format - The new stdoutFormat value
See Also:
KernelMBean.getStdoutFormat()

isStdoutLogStack

boolean isStdoutLogStack()
Deprecated. 9.0.0.0

Specifies whether to dump stack traces to the console when included in logged message.

Returns:
The stdoutLogStack value
Default Value:
true

setStdoutLogStack

void setStdoutLogStack(boolean stack)
Deprecated. 9.0.0.0

Sets the value of the StdoutLogStack attribute.

Parameters:
stack - The new stdoutLogStack value
See Also:
KernelMBean.isStdoutLogStack()

getStuckThreadMaxTime

int getStuckThreadMaxTime()
Deprecated. 9.0.0.0 replaced by ServerFailureTriggerMBean.getMaxStuckThreadTime()

The number of seconds that a thread must be continually working before this server considers the thread stuck.

For example, if you set this to 600 seconds, WebLogic Server considers a thread to be "stuck" after 600 seconds of continuous use.

In Web Logic Server 9.x and later, it is recommended that you use the ServerFailureTriggerMBean in the OverloadProtectionMBean. The ServerFailureTriggerMBean transitions the server to a FAILED state after the specified number of stuck threads are detected. The OverloadProtectionMBean has options to suspend or shutdown a failed server.

Returns:
The stuckThreadMaxTime value
Default Value:
600
Maximum Value:
java.lang.Integer.MAX_VALUE
Minimum Value:
0

setStuckThreadMaxTime

void setStuckThreadMaxTime(int seconds)
                           throws InvalidAttributeValueException
Deprecated. 9.0.0.0 replaced by ServerFailureTriggerMBean.setMaxStuckThreadTime()

Sets the value of the StuckThreadMaxTime attribute.

From WLS 9.0, it is recommended to used the ServerFailureTriggerMBean present in OverloadProtectionMBean. Setting the ServerFailureTriggerMBean transitions the server into FAILED state after the configured number of stuck threads are detected. OverloadProtectionMBean has options to suspend, shutdown a failed server.

Parameters:
seconds - The new stuckThreadMaxTime value
Throws:
InvalidAttributeValueException
See Also:
KernelMBean.getStuckThreadMaxTime()

getStuckThreadTimerInterval

int getStuckThreadTimerInterval()

The number of seconds after which WebLogic Server periodically scans threads to see if they have been continually working for the configured maximum length of time.

Returns:
The stuckThreadTimerInterval value
See Also:
KernelMBean.getStuckThreadMaxTime()
Default Value:
60
Maximum Value:
java.lang.Integer.MAX_VALUE
Minimum Value:
0

setStuckThreadTimerInterval

void setStuckThreadTimerInterval(int seconds)
                                 throws InvalidAttributeValueException

Sets the value of the StuckThreadTimerInterval attribute.

Parameters:
seconds - The new stuckThreadTimerInterval value
Throws:
InvalidAttributeValueException
See Also:
KernelMBean.getStuckThreadTimerInterval()

getMessagingBridgeThreadPoolSize

int getMessagingBridgeThreadPoolSize()
Deprecated. 9.0.0.0 replaced by a Work Manager named weblogic.jms.MessagingBridge

Returns the size of the messaging bridge execute thread pool.

Returns:
The messagingBridgeThreadPoolSize value
Default Value:
5

setMessagingBridgeThreadPoolSize

void setMessagingBridgeThreadPoolSize(int size)
                                      throws InvalidAttributeValueException,
                                             DistributedManagementException

Sets the value of the MessagingBridgeThreadPoolSize attribute.

Parameters:
size - The new messagingBridgeThreadPoolSize value
Throws:
InvalidAttributeValueException
DistributedManagementException
IllegalArgumentException - if the argument is null or represents a negative int.
See Also:
KernelMBean.getMessagingBridgeThreadPoolSize()
Maximum Value:
65534
Minimum Value:
-1

setUse81StyleExecuteQueues

void setUse81StyleExecuteQueues(boolean enable)

Backward compatibility mode to switch to 8.1 execute queues instead of WorkManagers. Each of the WorkManagers is converted to an individual execute queue. Setting this attribute requires a server restart.

Default Value:
false

getUse81StyleExecuteQueues

boolean getUse81StyleExecuteQueues()

Backward compatibility mode to switch to 8.1 execute queues instead of WorkManagers. Each of the WorkManagers is converted to an individual execute queue. Setting this attribute requires a server restart.

See Also:
KernelMBean.getUse81StyleExecuteQueues()
Default Value:
false

lookupExecuteQueue

ExecuteQueueMBean lookupExecuteQueue(String name)
Parameters:
name -
Returns:
ExecuteQueue object

setGatheredWritesEnabled

void setGatheredWritesEnabled(boolean enable)
Enables gathered writes over NIO Socket channels. Applicable only for NIO socketMuxer

Default Value:
false

isGatheredWritesEnabled

boolean isGatheredWritesEnabled()
Enables gathered writes over NIO socket channels. Enabling this attribute increases efficiency during I/O in environments with high network throughput and should be used only when configuring a WebLogic domain for Oracle Exalogic. For more information, see "Enabling Exalogic-Specific Enhancements in Oracle WebLogic Server 11g Release 1 (10.3.4)" in the Oracle Exalogic Deployment Guide.


setScatteredReadsEnabled

void setScatteredReadsEnabled(boolean enable)
Enables scattered reads over NIO Socket channels.Applicable only for NIO socketMuxer

Default Value:
false

isScatteredReadsEnabled

boolean isScatteredReadsEnabled()
Enables scattered reads over NIO socket channels. Enabling this attribute increases efficiency during I/O in environments with high network throughput and should be used only when configuring a WebLogic domain for Oracle Exalogic. For more information, see "Enabling Exalogic-Specific Enhancements in Oracle WebLogic Server 11g Release 1 (10.3.4)" in the Oracle Exalogic Deployment Guide.


setAddWorkManagerThreadsByCpuCount

void setAddWorkManagerThreadsByCpuCount(boolean flag)
Specifies whether self-tuning thread pool should increment thread count by CPU count

Since:
10.3.4.0

isAddWorkManagerThreadsByCpuCount

boolean isAddWorkManagerThreadsByCpuCount()
Enables increased efficiency of the self-tuning thread pool by aligning it with the Exalogic processor architecture threading capabilities. Enabling this attribute increases efficiency during I/O in environments with high network throughput and should be used only when configuring a WebLogic domain for Oracle Exalogic. For more information, see "Enabling Exalogic-Specific Enhancements in Oracle WebLogic Server 11g Release 1 (10.3.4)" in the Oracle Exalogic Deployment Guide.

Since:
10.3.4.0

setUseConcurrentQueueForRequestManager

void setUseConcurrentQueueForRequestManager(boolean flag)

Specifies if self-tuning should use buffer queue to park incoming requests

Since:
10.3.6.0

isUseConcurrentQueueForRequestManager

boolean isUseConcurrentQueueForRequestManager()

Reduces lock contention by using concurrent buffer queue to park incoming requests. Enabling this attribute increases throughput as requests are scheduled with out acquiring any locks.

Since:
10.3.6.0

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