RTI Connext Java API  Version 5.1.0
FlowControllerTokenBucketProperty_t Class Reference

com.rti.dds.publication.FlowController uses the popular token bucket approach for open loop network flow control. The flow control characteristics are determined by the token bucket properties. More...

Inherits Struct.

Public Attributes

int max_tokens
 Maximum number of tokens than can accumulate in the token bucket.
 
int tokens_added_per_period
 The number of tokens added to the token bucket per specified period.
 
int tokens_leaked_per_period
 The number of tokens removed from the token bucket per specified period.
 
Duration_t period
 Period for adding tokens to and removing tokens from the bucket.
 
int bytes_per_token
 Maximum number of bytes allowed to send for each token available.
 

Additional Inherited Members

- Public Member Functions inherited from Struct
abstract boolean equals (Object obj)
 
abstract int hashCode ()
 
String toString ()
 
- Protected Member Functions inherited from Struct
 Struct ()
 
abstract void pull_from_nativeI (long native_status)
 
abstract void push_to_nativeI (long native_status)
 

Detailed Description

com.rti.dds.publication.FlowController uses the popular token bucket approach for open loop network flow control. The flow control characteristics are determined by the token bucket properties.

Asynchronously published samples are queued up and transmitted based on the token bucket flow control scheme. The token bucket contains tokens, each of which represents a number of bytes. Samples can be sent only when there are sufficient tokens in the bucket. As samples are sent, tokens are consumed. The number of tokens consumed is proportional to the size of the data being sent. Tokens are replenished on a periodic basis.

The rate at which tokens become available and other token bucket properties determine the network traffic flow.

Note that if the same sample must be sent to multiple destinations, separate tokens are required for each destination. Only when multiple samples are destined to the same destination will they be co-alesced and sent using the same token(s). In other words, each token can only contribute to a single network packet.

Entity:
com.rti.dds.publication.FlowController
Properties:
RxO = N/A

Changeable = YES. However, the special value of com.rti.dds.infrastructure.Duration_t.INFINITE as com.rti.dds.publication.FlowControllerTokenBucketProperty_t.period is strictly used to create an on-demand com.rti.dds.publication.FlowController. The token period cannot toggle from an infinite to finite value (or vice versa). It can, however, change from one finite value to another.

Member Data Documentation

int max_tokens

Maximum number of tokens than can accumulate in the token bucket.

The number of tokens in the bucket will never exceed this value. Any excess tokens are discarded. This property value, combined with com.rti.dds.publication.FlowControllerTokenBucketProperty_t.bytes_per_token, determines the maximum allowable data burst.

Use com.rti.dds.infrastructure.ResourceLimitsQosPolicy.LENGTH_UNLIMITED to allow accumulation of an unlimited amount of tokens (and therefore potentially an unlimited burst size).

[default] com.rti.dds.infrastructure.ResourceLimitsQosPolicy.LENGTH_UNLIMITED

[range] [1,com.rti.dds.infrastructure.ResourceLimitsQosPolicy.LENGTH_UNLIMITED]

int tokens_added_per_period

The number of tokens added to the token bucket per specified period.

com.rti.dds.publication.FlowController transmits data only when tokens are available. Tokens are periodically replenished. This field determines the number of tokens added to the token bucket with each periodic replenishment.

Available tokens are distributed to associated com.rti.dds.publication.DataWriter instances based on the com.rti.dds.publication.FlowControllerProperty_t.scheduling_policy.

Use com.rti.dds.infrastructure.ResourceLimitsQosPolicy.LENGTH_UNLIMITED to add the maximum number of tokens allowed by com.rti.dds.publication.FlowControllerTokenBucketProperty_t.max_tokens.

[default] com.rti.dds.infrastructure.ResourceLimitsQosPolicy.LENGTH_UNLIMITED

[range] [1,com.rti.dds.infrastructure.ResourceLimitsQosPolicy.LENGTH_UNLIMITED]

int tokens_leaked_per_period

The number of tokens removed from the token bucket per specified period.

com.rti.dds.publication.FlowController transmits data only when tokens are available. When tokens are replenished and there are sufficient tokens to send all samples in the queue, this property determines whether any or all of the leftover tokens remain in the bucket.

Use com.rti.dds.infrastructure.ResourceLimitsQosPolicy.LENGTH_UNLIMITED to remove all excess tokens from the token bucket once all samples have been sent. In other words, no token accumulation is allowed. When new samples are written after tokens were purged, the earliest point in time at which they can be sent is at the next periodic replenishment.

[default] 0

[range] [0,com.rti.dds.infrastructure.ResourceLimitsQosPolicy.LENGTH_UNLIMITED]

Duration_t period

Period for adding tokens to and removing tokens from the bucket.

com.rti.dds.publication.FlowController transmits data only when tokens are available. This field determines the period by which tokens are added or removed from the token bucket.

The special value com.rti.dds.infrastructure.Duration_t.INFINITE can be used to create an on-demand com.rti.dds.publication.FlowController, for which tokens are no longer replenished periodically. Instead, tokens must be added explicitly by calling com.rti.dds.publication.FlowController.trigger_flow. This external trigger adds com.rti.dds.publication.FlowControllerTokenBucketProperty_t.tokens_added_per_period tokens each time it is called (subject to the other property settings).

[default] 1 second

[range] [0,1 year] or com.rti.dds.infrastructure.Duration_t.INFINITE

int bytes_per_token

Maximum number of bytes allowed to send for each token available.

com.rti.dds.publication.FlowController transmits data only when tokens are available. This field determines the number of bytes that can actually be transmitted based on the number of tokens.

Tokens are always consumed in whole by each com.rti.dds.publication.DataWriter. That is, in cases where com.rti.dds.publication.FlowControllerTokenBucketProperty_t.bytes_per_token is greater than the sample size, multiple samples may be sent to the same destination using a single token (regardless of com.rti.dds.publication.FlowControllerProperty_t.scheduling_policy).

Where fragmentation is required, the fragment size will be com.rti.dds.publication.FlowControllerTokenBucketProperty_t.bytes_per_token or the minimum largest message size across all transports installed with the com.rti.dds.publication.DataWriter, whichever is less.

Use com.rti.dds.infrastructure.ResourceLimitsQosPolicy.LENGTH_UNLIMITED to indicate that an unlimited number of bytes can be transmitted per token. In other words, a single token allows the recipient com.rti.dds.publication.DataWriter to transmit all its queued samples to a single destination. A separate token is required to send to each additional destination.

[default] com.rti.dds.infrastructure.ResourceLimitsQosPolicy.LENGTH_UNLIMITED

[range] [1024,com.rti.dds.infrastructure.ResourceLimitsQosPolicy.LENGTH_UNLIMITED]


RTI Connext Java API Version 5.1.0 Copyright © Mon Feb 3 2014 Real-Time Innovations, Inc