Administration Console Online Help

 Previous Next Contents Index  

 


JMS Connection Factory --> Configuration --> Flow Control

Tasks     Additional Documentation     Attributes

Overview

This tab defines flow control configuration attributes for a JMS connection factory. After defining a JMS server, you can configure one or more connection factories to create connections with predefined attributes.

Tasks

Create a JMS Connection Factory

Clone a JMS Connection Factory

Delete a JMS Connection Factory

Assign a JMS Connection Factory

Additional Documentation

(Requires an Internet connection.)

"Managing JMS"in the Administration Guide

"WebLogic JMS Fundamentals" in Programming WebLogic JMS

"Managing WebLogic JMS" in Programming WebLogic JMS

"Developing a WebLogic JMS Application"in Programming WebLogic JMS

Attributes

Attribute Label

Description

Value Constraints

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.

MBean: weblogic.management.
configuration.
JMSConnectionFactoryMBean

Attribute: FlowMaximum

Units: messages/second

Minimum: 1

Maximum: 2147483647

Default: 500

Configurable: yes

Dynamic: yes

Readable: yes

Writable: yes

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.

MBean: weblogic.management.
configuration.
JMSConnectionFactoryMBean

Attribute: FlowMinimum

Units: messages/second

Minimum: 1

Maximum: 2147483647

Default: 50

Configurable: yes

Dynamic: yes

Readable: yes

Writable: yes

Flow Interval (seconds)

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.

MBean: weblogic.management.
configuration.
JMSConnectionFactoryMBean

Attribute: FlowInterval

Units: seconds

Minimum: 0

Maximum: 2147483647

Default: 60

Configurable: yes

Dynamic: yes

Readable: yes

Writable: yes

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 (that is, 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 downward movement (the decay) is geometric over the specified period of time (Flow Interval) and according to the specified number of Flow Steps (for example, 100, 50, 25, 12.5).

  • The movement upward is linear. The difference is simply divided by the number of steps.

MBean: weblogic.management.
configuration.
JMSConnectionFactoryMBean

Attribute: FlowSteps

Minimum: 1

Maximum: 2147483647

Default: 10

Configurable: yes

Dynamic: yes

Readable: yes

Writable: yes

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.

MBean: weblogic.management.
configuration.
JMSConnectionFactoryMBean

Attribute: FlowControlEnabled

Default: true

Dynamic: yes

Readable: yes

Writable: yes



 

Back to Top Previous Next