WTCtBridgeGlobalMBean

Overview  |   Related MBeans  |   Attributes  |   Operations

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.

Since 7.0.0.0    
Security roles The following roles have read, write, and invoke permission for all non-encrypted attributes and operations in this MBean:

  • Deployer
   
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.WTCtBridgeGlobalMBean
   
Factory Methods No factory methods. Instances of this MBean are created automatically.

Attributes

This section describes the following attributes:

 

AllowNonStandardTypes

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).

   
Privileges Read/Write    
Type java.lang.String
Default Value NO
Legal Values

  • Yes

  • No

 

CachingDisabled

Private property that disables caching in proxies.

   
Privileges Read only    
Type boolean
Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.

 

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.

   
Privileges Read/Write    
Type java.lang.String
Default Value DEFAULT
Legal Values

  • PERSIST

  • NONPERSIST

  • DEFAULT

 

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: Overrides any delivery mode associated with a message.

   
Privileges Read/Write    
Type java.lang.String
Default Value NONPERSIST
Legal Values

  • PERSIST

  • NONPERSIST

 

JmsFactory

The name of the JMS connection factory.

Example: weblogic.jms.ConnectionFactory

   
Privileges Read/Write    
Type java.lang.String
Default Value weblogic.jms.XAConnectionFactory

 

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 "-".

   
Privileges Read/Write    
Type java.lang.String

 

JndiFactory

The name of the JNDI lookup factory.

Example: weblogic.jndi.WLInitialContextFactory

   
Privileges Read/Write    
Type java.lang.String
Default Value weblogic.jndi.WLInitialContextFactory

 

MBeanInfo

Returns the MBean info for this MBean.

Deprecated.

   
Privileges Read only    
Type javax.management.MBeanInfo
Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.

 

Name of

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 of=user-specified-name

   
Privileges Read/Write    
Type java.lang.String

 

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

 

ObjectName

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

Deprecated.

   
Privileges Read only    
Type weblogic.management.WebLogicObjectName
Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.

 

Parent

Return the immediate parent for this MBean

   
Privileges Read/Write    
Type

 

Registered

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

Deprecated.

   
Privileges Read only    
Type boolean
Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.

 

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.

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

 

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.

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

 

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.

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

 

Transactional

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.

   
Privileges Read/Write    
Type java.lang.String
Default Value NO
Legal Values

  • Yes

  • No

 

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.

   
Privileges Read/Write    
Type java.lang.String

 

TuxFactory

The name of the Tuxedo connection factory.

Example: tuxedo.services.TuxedoConnection

   
Privileges Read/Write    
Type java.lang.String
Default Value 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 "-".

   
Privileges Read/Write    
Type java.lang.String

 

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.

 

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).

   
Privileges Read/Write    
Type java.lang.String

 

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.

   
Privileges Read/Write    
Type java.lang.String

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

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