bundle-config

bundle-config

Used in: operation-bundling.

Description

The bundle-config element specifies the bundling strategy configuration for one or more bundle-able operations.

Elements

The following table describes the elements you can define within the operation-bundling element.

Element Required/Optional Description
<operation-name> Required Specifies the operation name for which calls performed concurrently on multiple threads will be "bundled" into a functionally analogous "bulk" operation that takes a collection of arguments instead of a single one.

Valid values depend on the bundle configuration context. For the cachestore-scheme the valid operations are "load", "store" and "erase". For the distributed-scheme and remote-cache-scheme the valid operations are "get", "put" and "remove". In all cases there is a pseudo operation named "all", referring to all valid operations.

Default value is "all".
<preferred-size> Optional Specifies the bundle size threshold. When a bundle size reaches this value, the corresponding "bulk" operation will be invoked
immediately. This value is measured in context-specific units.

Valid values are zero (disabled bundling) or positive values.

Default value is zero.
<delay-millis> Optional Specifies the maximum amount of time in milliseconds that individual execution requests are allowed to be deferred for a purpose of "bundling" them together and passing into a corresponding bulk operation. If the preferred-size threshold is reached before the specified delay, the bundle is processed immediately.

Valid values are positive numbers.

Default value is 1.
<thread-threshold> Optional Specifies the minimum number of threads that must be concurrently executing individual (non-bundled) requests for the bundler to switch from a pass-through to a bundling mode.

Valid values are positive numbers.

Default value is 4.
<auto-adjust> Optional Specifies whether or not the auto adjustment of the preferred-size value (based on the run-time statistics) is allowed.

Valid values are "true" or "false".

Default value is "false".