weblogic.management.configuration
Interface WTCtBridgeGlobalMBean

public interface WTCtBridgeGlobalMBean

extends ConfigurationMBean

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.

Fields inherited from class weblogic.management.configuration.ConfigurationMBean

CACHING_STUB_SVUID

Method Summary

java.lang.String	getAllowNonStandardTypes()
java.lang.String	getDefaultReplyDeliveryMode()
java.lang.String	getDeliveryModeOverride()
java.lang.String	getJmsFactory()
java.lang.String	getJmsToTuxPriorityMap()
java.lang.String	getJndiFactory()
int	getRetries()
int	getRetryDelay()
int	getTimeout()
java.lang.String	getTransactional()
java.lang.String	getTuxErrorQueue()
java.lang.String	getTuxFactory()
java.lang.String	getTuxToJmsPriorityMap()
java.lang.String	getUserId()
java.lang.String	getWlsErrorDestination()
void	setAllowNonStandardTypes(java.lang.String AllowNonStandardType) Defines a flag used to specify if non-standard data types are allowed to pass through the tBridge.
void	setDefaultReplyDeliveryMode(java.lang.String DefaultReplyDeliveryMode) Defines the reply delivery mode to associate with a message when placing messages onto the target location.
void	setDeliveryModeOverride(java.lang.String DeliveryModeOverride) Defines the delivery mode to use when placing messages onto the target location.
void	setJmsFactory(java.lang.String JmsFactory) Defines the name of the JMS connection factory.
void	setJmsToTuxPriorityMap(java.lang.String jms2tuxpmap) Defines the mapping of priorities from JMS to Tuxedo.
void	setJndiFactory(java.lang.String JndiFactory) Defines the name of the JNDI lookup factory.
void	setRetries(int Retries) Defines the number of attempts to redirect a message before putting the message in the specified error location and logging an error.
void	setRetryDelay(int RetryDelay) Defines the minimum amount of time (milliseconds) to wait before redirecting a message after a failure.
void	setTimeout(int Timeout) Defines the effective length of a timeout for an entire redirection (seconds) when placing a message on the target location.
void	setTransactional(java.lang.String isTransactional) Defines a flag that specifies the use of transactions when retrieving messages from a source location and when placing messages on a target location.
void	setTuxErrorQueue(java.lang.String TuxErrorQueue) Defines the name of the Tuxedo queue used to store a message that connot be redirected to a Tuxedo/Q source queue.
void	setTuxFactory(java.lang.String TuxFactory) Defines the name of the Tuxedo connection factory.
void	setTuxToJmsPriorityMap(java.lang.String tux2jmspmap) Defines the mapping of priorities to map from Tuxedo to JMS.
void	setUserId(java.lang.String UserId) Defines a user identity for all messages handled by the tBridge for ACL checks when security is configured.
void	setWlsErrorDestination(java.lang.String WlsErrorDestination) Defines the name of the location used to store WebLogic Server JMS messages when a message cannot be redirected.

Methods inherited from interface weblogic.management.configuration.ConfigurationMBean

addLinkMbeanAttribute, getNotes, isPersistenceEnabled, setNotes

Methods inherited from interface weblogic.management.WebLogicMBean

getMBeanInfo, getName, getObjectName, getParent, getType, isCachingDisabled, isRegistered, setName, setParent

Methods inherited from interface javax.management.DynamicMBean

getAttribute, getAttributes, invoke, setAttribute, setAttributes

Methods inherited from interface javax.management.MBeanRegistration

postDeregister, postRegister, preDeregister, preRegister

Methods inherited from interface javax.management.NotificationBroadcaster

addNotificationListener, getNotificationInfo, removeNotificationListener

Method Detail

setTransactional

public void setTransactional(java.lang.String isTransactional)
                      throws javax.management.InvalidAttributeValueException

Defines a flag that specifies the use of transactions when retrieving messages from a source location and when placing messages on a target location.

• If YES, transactions are used for both operations.
• If NO, transactions are not used for either operation.

Note: Transactional is not supported in this release.

Default Value: "YES"

Legal Value: ((value.compareToIgnoreCase("YES")==0) || (value.compareToIgnoreCase("NO")==0))

Parameters:

isTransactional - whether or not transactions should be used

getTransactional

public java.lang.String getTransactional()

setTimeout

public void setTimeout(int Timeout)
                throws javax.management.InvalidAttributeValueException

Defines the effective length of a timeout for an entire redirection (seconds) when placing a message on the target location. 0 indicates an infinite wait.

Default Value: 60

Legal Minimum Value: 0

Legal Maximum Value: java.lang.Integer.MAX_VALUE

Secure Value: 60

Parameters:

Timeout - timeout in seconds if transactions are used

getTimeout

public int getTimeout()

setRetries

public void setRetries(int Retries)
                throws javax.management.InvalidAttributeValueException

Defines the number of attempts to redirect a message before putting the message in the specified error location and logging an error.

Default Value: 0

Legal Minimum Value: 0

Legal Maximum Value: java.lang.Integer.MAX_VALUE

Parameters:

Retries - number of times to try redirecting a message

getRetries

public int getRetries()

setRetryDelay

public void setRetryDelay(int RetryDelay)
                   throws javax.management.InvalidAttributeValueException

Defines the minimum amount of time (milliseconds) to wait before redirecting a message after a failure. During this time, no other messages are redirected from the thread. Other threads may continue to redirect messages.

Default Value: 10

Legal Minimum Value: 0

Legal Maximum Value: java.lang.Integer.MAX_VALUE

Parameters:

RetryDelay - time in milliseconds to wait before retrying to redirect a msg

getRetryDelay

public int getRetryDelay()

setWlsErrorDestination

public void setWlsErrorDestination(java.lang.String WlsErrorDestination)
                            throws javax.management.InvalidAttributeValueException

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

Parameters:

WlsErrorDestination - error destination for JMS msg if redirects fail

getWlsErrorDestination

public java.lang.String getWlsErrorDestination()

setTuxErrorQueue

public void setTuxErrorQueue(java.lang.String TuxErrorQueue)
                      throws javax.management.InvalidAttributeValueException

Defines the name of the Tuxedo queue used to store a message that connot be redirected to a Tuxedo/Q source queue. This queue is in the same queue space as the 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.

Parameters:

TuxErrorQueue - error destination for Tux msg if redirects fail

getTuxErrorQueue

public java.lang.String getTuxErrorQueue()

setDeliveryModeOverride

public void setDeliveryModeOverride(java.lang.String DeliveryModeOverride)
                             throws javax.management.InvalidAttributeValueException

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

• Overrides any delivery mode associated with a message.
• If not specified, the message is placed on the target location with the same delivery mode specified from the source location.

Legal Values: "PERSIST","NONPERSIST"

Parameters:

DeliveryModeOverride - mode for placing messages onto target

getDeliveryModeOverride

public java.lang.String getDeliveryModeOverride()

setDefaultReplyDeliveryMode

public void setDefaultReplyDeliveryMode(java.lang.String DefaultReplyDeliveryMode)
                                 throws javax.management.InvalidAttributeValueException

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

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

Legal Values: "PERSIST","NONPERSIST","DEFAULT"

Parameters:

DefaultReplyDeliveryMode - reply mode for placing messages onto target

getDefaultReplyDeliveryMode

public java.lang.String getDefaultReplyDeliveryMode()

setUserId

public void setUserId(java.lang.String UserId)
               throws javax.management.InvalidAttributeValueException

Defines a user identity for all messages handled by the tBridge 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.
• The argument user may be specified as either a user name or a user identification number (uid).

Parameters:

UserId - user identification for all messages

getUserId

public java.lang.String getUserId()

setAllowNonStandardTypes

public void setAllowNonStandardTypes(java.lang.String AllowNonStandardType)
                              throws javax.management.InvalidAttributeValueException

Defines a flag used to specify if non-standard data types are allowed to pass through the tBridge. Standard types are: ASCII text (TextMessage, STRING), or BLOB (BytesMessage, CARRAY).

• NO: Non-standard types are rejected and placed onto a specified error location.
• YES: Non-standare types are placed on the target location as BLOBs with a tag indicating the original type.

Default Value: "NO"

Legal Value: ((value.compareToIgnoreCase("YES")==0) || (value.compareToIgnoreCase("NO")==0))

Parameters:

AllowNonStandardType - reply mode for placing messages onto target

getAllowNonStandardTypes

public java.lang.String getAllowNonStandardTypes()

setJndiFactory

public void setJndiFactory(java.lang.String JndiFactory)
                    throws javax.management.InvalidAttributeValueException

Defines the name of the JNDI lookup factory. Example: weblogic.jndi.WLInitialContextFactory

Legal NULL: false

Parameters:

JndiFactory - the Name lookup factory

getJndiFactory

public java.lang.String getJndiFactory()

setJmsFactory

public void setJmsFactory(java.lang.String JmsFactory)
                   throws javax.management.InvalidAttributeValueException

Defines the name of the JMS connection factory. Example: weblogic.jms.ConnectionFactory

Legal NULL: false

Parameters:

JmsFactory - the JMS connection factory

getJmsFactory

public java.lang.String getJmsFactory()

setTuxFactory

public void setTuxFactory(java.lang.String TuxFactory)
                   throws javax.management.InvalidAttributeValueException

Defines the name of the Tuxedo connection factory. Example: tuxedo.services.TuxedoConnection

Legal NULL: false

Parameters:

TuxFactory - the Tuxedo connection factory

getTuxFactory

public java.lang.String getTuxFactory()

setJmsToTuxPriorityMap

public void setJmsToTuxPriorityMap(java.lang.String jms2tuxpmap)
                            throws javax.management.InvalidAttributeValueException

Defines the mapping of priorities from JMS to Tuxedo. 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 "-".

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

Parameters:

jms2tuxpmap - list of value-to-range pairs

getJmsToTuxPriorityMap

public java.lang.String getJmsToTuxPriorityMap()

setTuxToJmsPriorityMap

public void setTuxToJmsPriorityMap(java.lang.String tux2jmspmap)
                            throws javax.management.InvalidAttributeValueException

Defines the mapping of priorities to map from Tuxedo to JMS. 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 "-".

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

Parameters:

tux2jmspmap - list of range-to-value pairs

getTuxToJmsPriorityMap

public java.lang.String getTuxToJmsPriorityMap()