CALCLOCKBLOCK

Sets the HIGH, DEFAULT, and LOW values for the calculation script SET LOCKBLOCK command, which specifies the maximum number of blocks that Analytic Services can fix (get addressability to) when calculating one block.

This setting does not apply to aggregate storage databases.

Syntax

CALCLOCKBLOCKHIGH | CALCLOCKBLOCKDEFAULT | CALCLOCKBLOCKLOW n

Where HIGH, DEFAULT, and LOW are levels:

HIGH Maximum number of blocks that a user can choose to fix concurrently when one data block is calculated. Maximum: half the number of blocks that fit into the data cache.
DEFAULT Default number of blocks that can be fixed concurrently.
LOW Minimum number of blocks that a user can choose to fix concurrently.
n Integer value for each level, representing the total number of blocks that can be locked concurrently.

Description

CALCLOCKBLOCK specifies the number of blocks that can be fixed at each level of the SET LOCKBLOCK HIGH | DEFAULT | LOW calculation script command.

When a block is calculated, Analytic Services fixes (gets addressability to) the block along with the blocks containing its children. Analytic Services calculates the block and then releases it along with the blocks containing its children. By default, Analytic Services allows up to 100 blocks to be fixed concurrently when calculating a block. This is sufficient for most database calculations. However, you may want to set a number higher than 100 if you are consolidating very large numbers of children in a formula calculation. This ensures that Analytic Services can fix all the required blocks when calculating a data block and that performance will not be impaired.

Notes

Example

If the essbase.cfg file contains the following settings:

CALCLOCKBLOCKHIGH 500
CALCLOCKBLOCKDEFAULT 200
CALCLOCKBLOCKLOW 50

then you can use the following SET LOCKBLOCK setting commands in a calculation script:

SET LOCKBLOCK HIGH;
means that Analytic Services can fix up to 500 data blocks when calculating one block.
SET LOCKBLOCK DEFAULT;
means that Analytic Services can fix up to 200 data blocks when calculating one block.
SET LOCKBLOCK LOW;
means that Analytic Services can fix up to 50 data blocks when calculating one block.

In essbase.cfg, a parameter is not followed by a semicolon; in a calculation script, a parameter must be followed by a semicolon.

See Also

SET LOCKBLOCK (calculation script command)

©2004 Hyperion Solutions Corporation. All Rights Reserved.
http://www.hyperion.com