WTCtBridgeGlobalMBean

Overview

This interface provides access to the WTC tBridge Global configuration attributes. The methods defined herein are applicable for tBridge configuration at the WLS domain level.

Attributes

This section describes the following attributes:

AllowNonStandardTypes

Specifies whether non-standard data types are allowed to pass through this Tuxedo queuing bridge.

A value of NO means that non standard types are rejected and placed onto a specified error location; a value of YES means that non-standard types are placed on the target location as BLOBs with a tag indicating the original type.

Note: Standard types are: ASCII text (TextMessage, STRING), or BLOB (BytesMessage, CARRAY).

CachingDisabled

Private property that disables caching in proxies.

DefaultReplyDeliveryMode

The reply delivery mode to associate with a message when placing messages onto the target location.

Usage Notes:

• Use when messages are being redirected to Tuxedo/Q from JMS and the JMS_BEA_TuxGtway_Tuxedo_ReplyDeliveryMode property is not set for a message.

• If the defaultReplyDeliveryMode and JMS_BEA_TuxGtway_Tuxedo_ReplyDeliveryMode are not set, the default semantics defined for Tuxedo are enforced by the Tuxedo/Q subsystem.

DeliveryModeOverride

The delivery mode to use when placing messages onto the target location.

If this value is not specified, the message is placed on the target location with the same delivery mode specified from the source location.

Note: This value overrides any delivery mode associated with a message.

DynamicallyCreated

Return whether the MBean was created dynamically or is persisted to config.xml

Id

Return the unique id of this MBean instance

JmsFactory

The name of the JMS connection factory.

Example: weblogic.jms.ConnectionFactory

JmsToTuxPriorityMap

The mapping of priorities from JMS to Tuxedo. The default JMS To Tux Priority Map is: 0:1 | 1:12 | 2:23 | 3:34 | 4:45 |5:56 | 6:67 | 7:78 | 8:89 | 9:100.

Examples: 0:1 | 1:12 | 2:23 | 3:34 | 4:45 | 5:56 | 6:67 | 7:78 | 8:89 | 9:100 or 0:1-10|1:11-20|2:21-30|3:31-40|4:41-50|5:51-60|6:61-70|7:71-80|8:81-90|9:91-100

Note: The are 10 possible JMS priorities(0=>9) which can be paired to 100 possible Tuxedo priorities(1=>100). A mapping consists of a "|" separated list of value-to-range pairs (jmsvalue:tuxrange) where pairs are separated by ":" and ranges are separated by "-".

JndiFactory

The name of the JNDI lookup factory.

Example: weblogic.jndi.WLInitialContextFactory

MBeanInfo

Returns the MBean info for this MBean.

Deprecated.

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

Notes

Optional information that you can include to describe this configuration.

WebLogic Server saves this note in the domain's configuration file (config.xml) as XML PCDATA. All left angle brackets (<) are converted to the XML entity <. 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.

ObjectName

Returns the ObjectName under which this MBean is registered in the MBean server.

Deprecated.

Parent

Return the immediate parent for this MBean

Registered

Returns false if the MBean represented by this object has been unregistered.

Deprecated.

Retries

The number of attempts to redirect a message before this Tuxedo queuing bridge places the message in the specified error location and logs an error.

Range of Values: Between 0 and a positive 32-bit integer.

RetryDelay

The minimum number of milliseconds this Tuxedo queuing bridge waits before redirecting a message after a failure.

Note: During this waiting period, no other messages are redirected from the thread. Other threads may continue to redirect messages.

Range of Values: Between 0 and a positive 32-bit integer.

Timeout

The number of timeout seconds for an entire redirection when this Tuxedo queuing bridge places a message on the target location. A value of 0 specifies an infinite wait.

Range of Values: Between 0 and a positive 32-bit integer.

Transactional

Specifies whether this Tuxedo queuing bridge should use transactions when retrieving messages from a source location and when placing messages on a target location.

A value of YES means that transactions are used for both operations; a value of NO means that transactions are not used for either operation.

Note: Transactional is not supported in this release.

TuxErrorQueue

The name of the Tuxedo queue used to store a message that cannot be redirected to a Tuxedo/Q source queue.

If not specified, all messages not redirected are lost. If the message cannot be placed into the TuxErrorQueue, an error is logged and the message is lost.

Note: This queue is in the same queue space as the source queue.

TuxFactory

The name of the Tuxedo connection factory.

Example: tuxedo.services.TuxedoConnection

TuxToJmsPriorityMap

The mapping of priorities to map from Tuxedo to JMS. The default JMS To Tux Priority Map is: 1-10:0 | 11-20:1 | 21-30:2 | 31-40:3| 41-50:4| 51-60:5 | 61-70:6 | 71-80:7 | 81-90:8 | 91-100:9.

Examples: 1:0 | 12:1 | 23:2 | 34:3 | 45:4 | 56:5 | 67:6 | 78:7 | 89:8 | 100:9 or 20:0-1 | 40:2-3 | 60:4-5 | 80:6-7 | 100:8-9

Note: The are 100 possible Tuxedo priorities(1=>100) which can be paired to 10 possible JMS priorities(0=>9). A mapping consists of a "|" separated list of value-to-range pairs (tuxvalue:jmsrange) where pairs are separated by ":" and ranges are separated by "-".

Type

Returns the type of the MBean.

UserId

The user identity for all messages handled by this Tuxedo queuing bridge for ACL checks when security is configured.

All messages assume this identity until the security/authentication contexts are passed between the subsystems. Until the security contexts are passed, there is no secure method to identify who generated a message received from the source location.

Note: The user argument may be specified as either a user name or a user identification number (uid).

WlsErrorDestination

The name of the location used to store WebLogic Server JMS messages when a message cannot be redirected.

If not specified, all messages not redirected are lost. If the message cannot be placed into WlsErrorDestination for any reason, an error is logged and the message is lost.

Operations

This section describes the following operations:

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

getInheritedProperties

return all properties' names whose value is inherited from template mbean. this is a convenient method to get inheritance info on multiple properties in one jmx call.

isInherited

Check if the value of a property is inherited from template mbean or not.

isSet

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

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

unSet

Restore the given property to its default value.