Administration Console Online Help

Server --> Protocols --> jCOM

Tasks Related Topics Attributes

Overview

Use this tab to enable and disable jCOM and configure various aspects of its behavior, including:

The NT Authentication Host address
Whether it runs in native or non-native mode
Whether the server logs memory usage
Whether prefetch enumeration is enabled
Whether jCOM is initialized in native mode

Note: You must be in the Admin security role to see the Security, CompatibilitySecurity, and Services —> jCOM nodes in the navigation tree.

Tasks

Enabling and Configuring jCOM

Attributes

Table 296-1

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 Valid values: true false
NT Authentication 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`
Enable Native Mode	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 Valid values: true false
Enable Memory Logging	Enables logging of memory usage MBean: `weblogic.management. configuration.COMMBean` Attribute: `MemoryLoggingEnabled`	Default: false Valid values: true false
Prefetch Enumeration	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 `NoSuchElementException` occurs. 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`	Valid values: true false
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 Valid values: true false

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

Valid values:

true

false

NT Authentication 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

Enable Native Mode

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

Valid values:

true

false

Enable Memory Logging

Enables logging of memory usage

MBean: weblogic.management. configuration.COMMBean

Attribute: MemoryLoggingEnabled

Default: false

Valid values:

true

false

Prefetch Enumeration

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 NoSuchElementException occurs. 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

Valid values:

true

false

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

Valid values:

true

false