# KernelMBean

Overview | Related MBeans | Attributes | Operations

## Overview

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.

Fully Qualified Interface Name | If you use the `getMBeanInfo` operation in MBeanTypeServiceMBean, supply the following value as this MBean's fully qualified interface name: `weblogic.management.configuration.KernelMBean`
Factory Methods | No factory methods. Instances of this MBean are created automatically.
Subtypes | The following MBeans extend or implement this MBean type:
ServerMBean |

## Related MBeans

This section describes attributes that provide access to other MBeans. For more information about the MBean hierarchy, refer to WebLogic Server MBean Data Model.

ExecuteQueues IIOP Log | SSL

### ExecuteQueues

Returns the execute queues configured for this server.

Factory Methods | `createExecuteQueue (java.lang.String name)` `destroyExecuteQueue (ExecuteQueueMBean queue)` Factory methods do not return objects. See Using factory methods.
Lookup Operation | `lookupExecuteQueue(String name)` Returns a `javax.management.ObjectName` for the instance of `ExecuteQueueMBean` named `name`.
Privileges | Read only
Type | ExecuteQueueMBean[]
Relationship type: | Containment.

### IIOP

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.

Factory Methods | No explicit creator method. The child shares the lifecycle of its parent.
Privileges | Read only
Type | IIOPMBean
Relationship type: | Containment.

### Log

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.

Factory Methods | No explicit creator method. The child shares the lifecycle of its parent.
Privileges | Read only
Type | LogMBean
Relationship type: | Containment.

### SSL

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.

Factory Methods | No explicit creator method. The child shares the lifecycle of its parent.
Privileges | Read only
Type | SSLMBean
Relationship type: | Containment.

## Attributes

This section describes the following attributes:

AdministrationProtocol CompleteCOMMessageTimeout CompleteHTTPMessageTimeout CompleteIIOPMessageTimeout CompleteMessageTimeout CompleteT3MessageTimeout DefaultProtocol DefaultSecureProtocol DGCIdlePeriodsUntilTimeout IdleConnectionTimeout IdleIIOPConnectionTimeout IdlePeriodsUntilTimeout IIOPTxMechanism InstrumentStackTraceEnabled LogRemoteExceptionsEnabled MaxCOMMessageSize MaxHTTPMessageSize MaxIIOPMessageSize MaxMessageSize MaxOpenSockCount | MaxT3MessageSize MessagingBridgeThreadPoolSize MuxerClass Name NativeIOEnabled Notes OutboundEnabled OutboundPrivateKeyEnabled Parent PeriodLength ReverseDNSAllowed SocketBufferSizeAsChunkSize SocketReaders StuckThreadMaxTime StuckThreadTimerInterval ThreadPoolPercentSocketReaders Type Use81StyleExecuteQueues

### AdministrationProtocol

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

Privileges | Read/Write
Type | java.lang.String
Legal Values | t3s https iiops t3 http iiop

### CompleteCOMMessageTimeout

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.

Deprecated. 8.1.0.0 use NetworkAccessPointMBean#getCompleteMessageTimeout()

For more information, see:

- NetworkAccessPointMBean#getCompleteMessageTimeout

Available Since | Release 7.0.0.0
Privileges | Read/Write
Type | int
Default Value | -1
Minimum value | -1
Maximum value | 480

### CompleteHTTPMessageTimeout

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.

Deprecated. 8.1.0.0 use NetworkAccessPointMBean#getCompleteMessageTimeout()

For more information, see:

- NetworkAccessPointMBean#getCompleteMessageTimeout

Privileges | Read/Write
Type | int
Default Value | -1
Minimum value | -1
Maximum value | 480
Secure value | 60

### CompleteIIOPMessageTimeout

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.

Deprecated. 8.1.0.0 use NetworkAccessPointMBean#getCompleteMessageTimeout()

Privileges | Read/Write
Type | int
Default Value | -1
Minimum value | -1
Maximum value | 480
Secure value | 60

### CompleteMessageTimeout

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.

For more information, see:

- NetworkAccessPointMBean#getCompleteMessageTimeout

Privileges | Read/Write
Type | int
Default Value | 60
Minimum value | 0
Maximum value | 480

### CompleteT3MessageTimeout

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.

Deprecated. 8.1.0.0 use NetworkAccessPointMBean#getCompleteMessageTimeout()

For more information, see:

- NetworkAccessPointMBean#getCompleteMessageTimeout

Privileges | Read/Write
Type | int
Default Value | -1
Minimum value | -1
Maximum value | 480
Secure value | 60

### DefaultProtocol

The protocol to use for connections when none is specified.

Privileges | Read/Write
Type | java.lang.String
Default Value | t3
Legal Values | t3 t3s http https iiop iiops

### DefaultSecureProtocol

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

Privileges | Read/Write
Type | java.lang.String
Default Value | t3s
Legal Values | t3s https iiops

### DGCIdlePeriodsUntilTimeout

The number of idle periods allowed before object is collected.

Privileges | Read/Write
Type | int
Default Value | 5

### IdleConnectionTimeout

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.

For more information, see:

- NetworkAccessPointMBean#getIdleConnectionTimeout

Privileges | Read/Write
Type | int
Default Value | 65
Minimum value | 0
Secure value | 65

### IdleIIOPConnectionTimeout

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.

Deprecated. 8.1.0.0 use NetworkAccessPointMBean#getIdleConnectionTimeout()

Privileges | Read/Write
Type | int
Default Value | -1
Minimum value | -1
Secure value | 60

### IdlePeriodsUntilTimeout

The number of idle periods until peer is considered unreachable

Privileges | Read/Write
Type | int
Default Value | 4
Minimum value | 4
Maximum value | 65534

### IIOPTxMechanism

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.

Deprecated. 8.1.0.0 use IIOPMBean#getTxMechanism()

Privileges | Read/Write
Type | java.lang.String
Default Value | ots
Legal Values | ots jta

### InstrumentStackTraceEnabled

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.

Privileges | Read/Write
Type | boolean
Default Value | true

### LogRemoteExceptionsEnabled

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

Privileges | Read/Write
Type | boolean
Secure value | true

### MaxCOMMessageSize

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.

Deprecated. 8.1.0.0 use NetworkAccessPointMBean#getMaxMessageSize()

For more information, see:

- KernelMBean#getMaxMessageSize
- NetworkAccessPointMBean#getMaxMessageSize

Available Since | Release 7.0.0.0
Privileges | Read/Write
Type | int
Default Value | -1

### MaxHTTPMessageSize

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.

Deprecated. 8.1.0.0 use NetworkAccessPointMBean#getMaxMessageSize()

For more information, see:

- KernelMBean#getMaxMessageSize
- NetworkAccessPointMBean#getMaxMessageSize

Privileges | Read/Write
Type | int
Default Value | -1

### MaxIIOPMessageSize

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.

Deprecated. 8.1.0.0 use NetworkAccessPointMBean#getMaxMessageSize()

For more information, see:

- KernelMBean#getMaxMessageSize
- NetworkAccessPointMBean#getMaxMessageSize

Privileges | Read/Write
Type | int
Default Value | -1

### MaxMessageSize

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.

For more information, see:

- NetworkAccessPointMBean

Privileges | Read/Write
Type | int
Default Value | 10000000
Minimum value | 4096
Maximum value | 2000000000
Secure value | 10000000

### MaxOpenSockCount

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.

Privileges | Read/Write
Type | int
Default Value | -1
Minimum value | -1
Maximum value | 2147483647

### MaxT3MessageSize

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.

Deprecated. 8.1.0.0 use NetworkAccessPointMBean#getMaxMessageSize()

For more information, see:

- KernelMBean#getMaxMessageSize
- NetworkAccessPointMBean#getMaxMessageSize

Privileges | Read/Write
Type | int
Default Value | -1

### MessagingBridgeThreadPoolSize

Returns the size of the messaging bridge execute thread pool.

Deprecated. 9.0.0.0 replaced by a Work Manager named weblogic.jms.MessagingBridge

Privileges | Read/Write
Type | int
Default Value | 5
Minimum value | -1
Maximum value | 65534

### MuxerClass

The muxer class name.

Privileges | Read/Write
Type | java.lang.String

### Name

The user-specified name of this MBean instance.

This name is included as one of the key properties in the MBean's `javax.management.ObjectName`:
`Name=user-specified-name`

Privileges | Read/Write
Type | java.lang.String

### NativeIOEnabled

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

For more information, see:

- getSocketReaderTimeoutMaxMillis

Privileges | Read/Write
Type | boolean
Default Value | true

### Notes

Optional information that you can include to describe this configuration.

WebLogic Sever saves this note in the domain's configuration file (`config.xml`) as XML PCDATA. All left angle brackets (<) are converted to the XML entity `&lt;`. Carriage returns/line feeds are preserved.

Note:

  If you create or edit a note from the Administration Console, the Administration Console does not preserve carriage returns/line feeds.

Privileges | Read/Write
Type | java.lang.String

### OutboundEnabled

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.

For more information, see:

- NetworkAccessPointMBean#isOutboundEnabled

Privileges | Read/Write
Type | boolean

### OutboundPrivateKeyEnabled

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.

For more information, see:

- isOutboundEnabled

Privileges | Read/Write
Type | boolean

### Parent

Return the immediate parent for this MBean

Privileges | Read/Write
Type |

### PeriodLength

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

Privileges | Read/Write
Type | int
Default Value | 60000
Minimum value | 0

### ReverseDNSAllowed

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

Privileges | Read/Write
Type | boolean

### SocketBufferSizeAsChunkSize

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.

Privileges | Read/Write
Type | boolean

### SocketReaders

The number of socket reader threads

Privileges | Read/Write
Type | int
Default Value | -1
Minimum value | -1
Maximum value | 65534

### StuckThreadMaxTime

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.

Deprecated. 9.0.0.0 replaced by ServerFailureTriggerMBean.getMaxStuckThreadTime()

Privileges | Read/Write
Type | int
Default Value | 600
Minimum value | 0
Maximum value | 2147483647

### StuckThreadTimerInterval

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.

For more information, see:

- getStuckThreadMaxTime

Privileges | Read/Write
Type | int
Default Value | 60
Minimum value | 0
Maximum value | 2147483647

### ThreadPoolPercentSocketReaders

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

Privileges | Read/Write
Type | int
Default Value | 33
Minimum value | 1
Maximum value | 99

### Type

Returns the type of the MBean.

Privileges | Read only
Type | java.lang.String
Redeploy or Restart required | Changes take effect after you redeploy the module or restart the server.

### Use81StyleExecuteQueues

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.

For more information, see:

- getUse81StyleExecuteQueues

Privileges | Read/Write
Type | boolean

## Operations

This section describes the following operations:

freezeCurrentValue isSet restoreDefaultValue | unSet

### freezeCurrentValue

If the specified attribute has not been set explicitly, and if the attribute has a default value, this operation forces the MBean to persist the default value.

Unless you use this operation, the default value is not saved and is subject to change if you update to a newer release of WebLogic Server. Invoking this operation isolates this MBean from the effects of such changes.

Note:

  To insure that you are freezing the default value, invoke the `restoreDefaultValue` operation before you invoke this.

This operation has no effect if you invoke it on an attribute that does not provide a default value or on an attribute for which some other value has been set.

Deprecated. 9.0.0.0

Operation Name | `"freezeCurrentValue"`
Parameters | `Object [] { attributeName }` where: `attributeName` is an object of type `java.lang.String` that specifies: attributeName
Signature | `String [] { "java.lang.String" }`
Returns | `void`
Exceptions | `javax.management.AttributeNotFoundException` `javax.management.MBeanException`

### isSet

Returns true if the specified attribute has been set explicitly in this MBean instance.

Operation Name | `"isSet"`
Parameters | `Object [] { propertyName }` where: `propertyName` is an object of type `java.lang.String` that specifies: property to check
Signature | `String [] { "java.lang.String" }`
Returns | `boolean`

### restoreDefaultValue

If the specified attribute has a default value, this operation removes any value that has been set explicitly and causes the attribute to use the default value.

Default values are subject to change if you update to a newer release of WebLogic Server. To prevent the value from changing if you update to a newer release, invoke the `freezeCurrentValue` operation.

This operation has no effect if you invoke it on an attribute that does not provide a default value or on an attribute that is already using the default.

Deprecated. 9.0.0.0

Operation Name | `"restoreDefaultValue"`
Parameters | `Object [] { attributeName }` where: `attributeName` is an object of type `java.lang.String` that specifies: attributeName
Signature | `String [] { "java.lang.String" }`
Returns | `void`
Exceptions | `javax.management.AttributeNotFoundException`

### unSet

Restore the given property to its default value.

Operation Name | `"unSet"`
Parameters | `Object [] { propertyName }` where: `propertyName` is an object of type `java.lang.String` that specifies: property to restore
Signature | `String [] { "java.lang.String" }`
Returns | `void`