Administration Console Online Help

 Previous Next Contents Index  

 


Server --> Connections --> jCOM

Overview

This tab defines configuration attributes for controlling various aspects of communication between COM applications and WebLogic Server, such as authentication, timeouts and packet sizes. Use the attribute fields on this tab to:

Tasks

Tasks are divided into two categories: those that require a server restart for the attribute change to take effect and those that don't. All but two require a server restart. We describe those two tasks first.

Limiting the Size of a COM Message Packet WebLogic Server Accepts

Limiting the Number of Seconds WLS Waits for a Complete COM Message

Allowing or Disallowing COM Calls on the Server's Listen Port

Setting the Primary Domain Controller to be Used for Authentication

Allowing or Disallowing Native Mode Communication

Enabling or Disabling the Logging of Memory Usage

Allowing Prefetching of Elements

Allowing or Disallowing Apartment Threaded COM Initialization in Native Mode

Additional Documentation

(Requires an Internet connection.)

Programming WebLogic jCOM.

Attributes

Attribute Label

Description

Value Constraints

Enable COM

Whether or not COM support is enabled on the plaintext port. (COM is not supported on the SSL port.)

MBean: weblogic.management.
configuration.ServerMBean

Attribute: COMEnabled

Default: false

Readable: yes

Writable: yes

COM Max Message Size

Specify the maximum COM message size allowable in a message header. This attribute attempts to prevent a denial of service attack whereby a caller attempts to force the server to allocate more memory than is available thereby keeping the server from responding quickly to other requests. This setting only applies to connections that are initiated using one of the default ports (ServerMBean setListenPort and setAdministrationPort or SSLMBean setListenPort). Connections on additional ports are tuned via the NetworkChannelMBean.

MBean: weblogic.management.
configuration.ServerMBean

Attribute: MaxCOMMessageSize

Units: bytes

Minimum: 4096

Maximum: 2000000000

Default: 10000000

Configurable: yes

Dynamic: yes

Readable: yes

Writable: yes

COM Message Timeout

Specify the maximum number of seconds spent waiting for a complete COM message to be received. This attribute 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. This setting only applies to connections that are initiated using one of the default ports (ServerMBean setListenPort and setAdministrationPort or SSLMBean setListenPort). Connections on additional ports are tuned via the NetworkChannelMBean.

MBean: weblogic.management.
configuration.ServerMBean

Attribute: CompleteCOMMessageTimeout

Units: seconds

Minimum: 0

Maximum: 480

Default: 60

Configurable: yes

Dynamic: yes

Readable: yes

Writable: yes

NTAuth Host

The address of the primary domain controller to be used for authenticating clients. If this property is not set, COM clients will not be authenticated.

MBean: weblogic.management.
configuration.COMMBean

Attribute: NTAuthHost

Configurable: yes

Readable: yes

Writable: yes

Native Mode Enabled

Use native DLLs to allow Java objects to interact with COM Objects. Only supported on Windows.

MBean: weblogic.management.
configuration.COMMBean

Attribute: NativeModeEnabled

Default: false

Readable: yes

Writable: yes

Memory Logging Enabled

Enables logging of memory usage

MBean: weblogic.management.
configuration.COMMBean

Attribute: MemoryLoggingEnabled

Default: false

Readable: yes

Writable: yes

Prefetch Enums

Some COM methods return a COM VariantEnumeration type. The java2com tool automatically converts the returned type into a java.lang.Enumeration. This is not a perfect match since COM enumerations have no equivalent to the hasMoreElements() call. The client must continue to call nextElement until a NoSuchElementExceptionoccurs. Setting this property will cause jCOM to prefetch the next element in behind the scenes and return the correct value when hasMoreElements is called.

MBean: weblogic.management.
configuration.COMMBean

Attribute: PrefetchEnums

Readable: yes

Writable: yes

Apartment Threaded

Controls the flag that is used to initialize COM in native mode. By default, jCOM initializes COM using the COINIT_MULTITHREADED_FLAG. If the server logs a Class Not Registered Message when using native mode, try setting this property. (COINIT_APARTMENTTHREADED)

MBean: weblogic.management.
configuration.COMMBean

Attribute: ApartmentThreaded

Default: false

Readable: yes

Writable: yes



 

Back to Top Previous Next