JMSConnectionFactory

This class represents a JMS connection factory. Connection factories are objects that enable JMS clients to create JMS connections.

Table 29-1 JMSConnectionFactoryMBean Element Attributes

Attribute	Description	Range of Values and Default	Console Label
Acknowledge-Policy	The value of the AcknowledgePolicy attribute for the connection factory. Note: This attribute only applies to implementations that use the CLIENT_ACKNOWLEDGE acknowledge mode for a non-transacted session. This attribute works around a change in the JMS specification. Specifically, the specification allowed users to acknowledge all messages before and including the message geing acknowledged. The specification was changed so that acknowledging any message acknowledges all messages ever received (even those received after the message being acknowledge), as follows: An acknowledge policy of ACKNOWLEDGE_PREVIOUS retains the old behavior (acknowledge all message up to and including the message being acknowledged). An acknowledge policy of ACKNOWLEDGE_ALL yields the new behavior, where all messages received by the given session are acknowledged regardless of which message is being used to effect the acknowledge.	Default: All Valid values: All Previous	Acknowledge Policy
Allow-Close-In-On-Message	The value of the AllowCloseInOnMessage attribute for the connection factory. Indicates whether or not a connection factory creates message consumers that allow a close() method to be issued within its onMessage() method call. If selected (true), a close() method call from within an onMessage() method call will succeed instead of blocking forever. If the acknowledge mode of the session is set to AUTO_ACKNOWLEDGE, the current message will still be acknowledged automatically when the onMessage() call completes. If not selected (false), it will cause the stop() and close() methods to hang if called from onMessage(). This attribute is dynamic and can be changed at any time. However, changing the value does not affect existing connections. It only affects new connections made with this connection factory.	Default: false	Allow Close In On Message
Client-Id	The client ID for a durable subscriber that uses this connection factory.		Client Id
Default-Delivery-Mode	The value of the DefaultDeliveryMode attribute for the connection factory. The default delivery mode used for messages for which a delivery mode is not explicitly defined. All messages with a DefaultDeliveryModeof null that are produced on a connection created with this factory will receive this value.	Default: PERSISTENT Valid values: PERSISTENT NON_PERSISTENT	Default Delivery Mode
Default-Priority	The defaultPriority attribute for the connection factory. The default priority used for messages for which a priority is not explicitly defined. All messages with a DefaultPriorityof -1 that are produced on a connection created with this factory will receive this value.	Default: PRIORITY_DEFAULT Minimum: PRIORITY_MINIMUM Maximum: PRIORITY_MAXIMUM	Default Priority
Default-Redelivery-Delay	The value of the defaultRedeliveryDelay attribute for the connection factory. A redelivery delay defines the delay, in milliseconds, before rolled back or recovered messages are redelivered. All messages consumed by a consumer created with this factory that have a DefaultRedeliveryDelayof -1 will use this value.	Default: 0 Minimum: 0 Maximum: 9223372036854775807	Default Redelivery Delay
Default-Time-To-Deliver	The value of the DefaultTimeToDeliver attribute for the connection factory. A time-to-deliver defines the delay, in milliseconds, between when a message is produced and when it is made visible on its destination. All messages produced by a producer created with this factory that have a DefaultTimeToDeliverof -1 will use this value.	Default: 0 Minimum: 0 Maximum: 9223372036854775807	Default Time To Deliver
Default-Time-To-Live	The value of the DefaultTimeToLive attribute for the connection factory. The default maximum length of time, in milliseconds, that a message will exist. Used for messages for which a priority was not explicitly defined. A value of 0 indicates that the message has an infinite amount time to live. All messages with a DefaultTimeToLiveof -1 that are produced on a connection created with this factory will receive this value expressed in milliseconds.	Default: 0 Minimum: 0 Maximum: 9223372036854775807	Default Time To Live
Deployment-Order	A priority that the server uses to determine when it deploys an item. The priority is relative to other deployable items of the same type. For example, the server prioritizes and deploys all startup classes before it prioritizes and deploys EJBs. Items with the lowest Deployment Order value are deployed first. There is no guarantee on the order of deployments with equal Deployment Order values. There is no guarantee of ordering across clusters.	Default: 1000 Minimum: 0 Maximum: 2147483647	Deployment Order
Flow-Control-Enabled	The value of the FlowControlEnabled attribute for the connection factory. Indicates whether or not a producer created using a connection factory allows flow control. If true, the associated message producers will be slowed down if the JMS server reaches Btyes/Messages ThresholdHigh.	Default: true	Flow Control Enabled
Flow-Interval	The value of the FlowInterval attribute for the connection factory. An adjustment period of time, defined in seconds, when a producer adjusts its flow from the Flow Maximum number of messages to the Flow Minimum amount, or vice versa. When a producer is flow controlled it is slowed down from its FlowMaximum to its FlowMinimum over FlowIntervalseconds.	Default: 60 Minimum: 0 Maximum: 2147483647 Units: seconds	Flow Interval (seconds)
Flow-Maximum	The value of the FlowMaximum attribute for the connection factory. The maximum number of messages per second for a producer that is experiencing a threshold condition. When a producer is flow controlled it will never be allowed to go faster than FlowMaximum messages per second. If a producer is not currently limiting its flow when a threshold condition is reached, the initial flow limit for that producer is set to Flow Maximum. If a producer is already limiting its flow when a threshold condition is reached (the flow limit is less than Flow Maximum), then the producer will continue at its current flow limit until the next time the flow is evaluated. Note:Once a threshold condition has subsided, the producer is not permitted to ignore its flow limit. If its flow limit is less than the Flow Maximum, then the producer must gradually increase its flow to the Flow Maximum each time the flow is evaluated. When the producer finally reaches the Flow Maximum, it can then ignore its flow limit and send without limiting its flow.	Default: 500 Minimum: 0 Maximum: 2147483647 Units: messages/second	Flow Maximum
Flow-Minimum	The value of the FlowMinimum attribute for the connection factory. The minimum number of messages per second for a producer that is experiencing a threshold condition. This is the lower boundary of a producer's flow limit. That is, WebLogic JMS will not further slow down a producer whose message flow limit is at its Flow Minimum. When a producer is flow controlled it will never be required to go slower than FlowMinimummessages per second.	Default: 50 Minimum: 0 Maximum: 2147483647 Units: messages/second	Flow Minimum
Flow-Steps	The value of the FlowSteps attribute for the connection factory. The number of steps used when a producer is adjusting its flow from the Flow Maximum amount of messages to the Flow Minimum amount, or vice versa. Specifically, the Flow Interval adjustment period is divided into the number of Flow Steps (for example, 60 seconds divided by 6 steps is 10 seconds per step). Also, the movement (i.e., the rate of adjustment) is calculated by dividing the difference between the Flow Maximum and the Flow Minimum into steps. At each Flow Step, the flow is adjusted upward or downward, as necessary, based on the current conditions, as follows: The movement downward (the decay) is geometric (taking the nth root of the difference, where n is the number of steps). The movement upward is linear. The difference is simply divided by the number of steps.	Default: 10 Minimum: 1 Maximum: 2147483647	Flow Steps
JNDIName	The JNDI name of the JMS connection factory. This is the name that is assigned to and used to look up the connection factory within the JNDI namespace. The connection factory name is configured separately.		JNDIName
Load-Balancing-Enabled	The value of the LoadBalancingEnabled attribute for the connection factory. Indicates whether or not a producer created using a connection factory allows load balancing: If true, the associated message producers will be load balanced on every send() or publish(). If false, the associated message producers will be load balanced on the first send() or publish().	Default: true	Load Balancing Enabled
Messages-Maximum	The value of the MessagesMaximum attribute for the connection factory. The maximum number of messages that may exist for an asynchronous session and that have not yet been passed to the message listener. A value of -1 indicates that there is no limit on the number of messages. In this case, however, the limit is set to the amount of remaining virtual memory. When the number of messages reaches the MessagesMaximum value: For multicast sessions, new messages are discarded according the policy specified by the OverrunPolicy attribute and a DataOverrunException is thrown. For non-multicast sessions, new messages are flow-controlled, or retained on the server until the application can accommodate the messages. For multicast sessions, when a connection is stopped, messages will continue to be delivered, but only until the MessagesMaximum value is reached. Once this value is reached, messages will be discarded based on the Overrun policy.	Default: 10 Minimum: -1 Maximum: 2147483647	Messages Maximum
Name	The name of this configuration. WebLogic Server uses an MBean to implement and persist the configuration.		Name
Notes	Optional information that you can include to describe this configuration.		Notes
Overrun-Policy	The value of the OverrunPolicy attribute for the connection factory. Th Overrun Policy applies to multicast messages. When the number of outstanding messages reaches the MessagesMaximum attribute value, messages are discarded based on the specified policy. If set to KeepNew, the most recent messages are given priority over the oldest messages, and the oldest messages are discarded, as needed. If set to KeepOld, the oldest messages are given priority over the most recent messages, and the most recent messages are discarded, as needed. Message age is defined by the order of receipt, not by the JMSTimestamp value.	Default: KeepOld Valid values: KeepOld KeepNew	Overrun Policy
Server-Affinity-Enabled	The value of the ServerAffinityEnabled attribute for the connection factory when load balancing consumers or producers across multiple physical destinations in a distributed destination. Indicates whether or not JMS front-ends that are connected to and running in the same JVM as a WebLogic Server will first attempt to load balance consumers or producers across those physical destinations served by any JMS servers that are also running in the same JVM.	Default: true	Server Affinity Enabled
Targets	The targets in the current domain on which this item can be deployed.		Targets
Transaction-Timeout	The value of the TransactionTimeout attribute for the connection factory. All transactions on connections created with this connection factory will have this timeout value expressed in seconds. If a transacted session is still active after the timeout has elapsed, the transaction is rolled back. A value of 0 indicates that the default value will be used. If you have long-running transactions, you might want to adjust the value of this attribute to allow transactions to complete.	Default: 3600 Minimum: 0 Maximum: 2147483647	Transaction Timeout
User-Transactions-Enabled	The value of the UserTransactionsEnabled attribute. Indicates whether or not a connection factory creates sessions that are JTA aware. If true, the associated message producers and message consumers look into the running thread for a transaction context. Otherwise, the current JTA transaction will be ignored. However, if the XAConnectionFactoryEnabled flag is set (true), the UserTransactionsEnabled attribute is ignored (since it is always considered true). Note:Transacted sessions ignore the current threads transaction context in favor of their own internal transaction, regardless of the setting. This setting only affects non-transacted sessions.	Default: false	User Transactions Enabled
XAConnection-Factory-Enabled	The value of the XAConnectionFactoryEnabled attribute for the connection factory. Indicates whether or not a XA queue or XA topic connection factory is returned, instead of a queue or topic connection factory. It can be used to return a XA queue session or XA topic session, which has the getXAResource method.	Default: false	XAConnection Factory Enabled
XAServer-Enabled	The value of the XAServerEnabled attribute for the connection factory. If true, an XA connection factory will be returned instead of a standard connection factory.	Default: false	Server Side XA Enabled