Juggler - throttleBytesPerMinute

 

Description

Allows you to limit the data flow either from an external site or to an external site. This agent works in conjunction with a bytesPerMinuteResourcePool Daemon.

See Resource Management -Model & Implementation for a general description of the PAM consumer-resource model. 

Configuration Variables

bytesPerMinutePoolId
The name of the pool that this consumer of "bytesPerMinute" will consume out of. There is no default. A name must be specified to enable the "throttling" function. When a name is specified, a bytesPerMinuteResourcePool by that name will be created if it does not already exist.

bytesPerMinuteConsumption

A number that identifies a running average of how many bytes per minute have been moved through this agent. Writing this value will reset the history for this agent and affect the running average. A new running average is computed when this attribute is read - so generally this attribute's value will always change.

useBytesPerMinutePoolWeight

Defaults to false. When true it indicates that this agent will have a portion of the bytesPerMinuteResourcePool reserved for this agents use. The reserved amount is relative to that allocated to other throttleBytesPerMinute consumers in the pool.

bytesPerMinutePoolWeight

Defaults to 1.0. A number that indicates the relative reservation of the bytesPerMinuteResourcePool's budget for this agent. Only applicable if useBytesPerMinutePoolWeight is true.

How it works

This agent checks with its associated bytesPerMinuteResourcePool every time a new product is to be output. If useBytesPerMinutePoolWeight is false and the size of the product would cause the pool to exceed its budget then this agent will delay output of the product until such a time as the product can be output without exceeding the pool's budget. See bytesPerMinuteResourcePool, How it works.

If useBytesPerMinutePoolWeight is true the sliding window history and statistics are maintained individually for the instance of this juggler.

 

  

Revised: 23 April 1999