SET CACHE

Specifies the size of the calculator cache.

Syntax

SET CACHE HIGH | DEFAULT | LOW | OFF | ALL;

HIGH, DEFAULT, and LOW Levels defining the size of the calculator cache. You set the values of HIGH, DEFAULT and LOW in the essbase.cfg file. If you do not set the value of DEFAULT in the essbase.cfg file, Analytic Services uses a default value of 200,000 bytes. The maximum calculator cache size that you can specify is 200,000,000 bytes.
OFF Analytic Services does not use a calculator cache.
ALL Analytic Services uses a calculator cache, even when you do not calculate at least one full sparse dimension.

Description

SET CACHE specifies the size of the calculator cache.

Analytic Services uses the calculator cache to create and track data blocks during calculation. Using the calculator cache significantly improves your calculation performance. The size of the performance improvement depends on the configuration of your database.

You can choose one of three levels. The size of the calculator cache at each level is defined using the CALCCACHE {HIGH | DEFAULT | LOW} settings in the essbase.cfg file.

The level you choose depends on the amount of memory your system has available and the configuration of your database. For detailed information on setting the size of your calculator cache, see the Database Administrator's Guide.

You can specify whether, by default, Analytic Services uses a calculator cache using the CALCCACHE TRUE | FALSE setting in the essbase.cfg file. By default, CALCCACHE is set to TRUE.

Analytic Services uses the calculator cache providing that:

You can use this command more than once within a calculation script.

You can display the calculator cache setting using the SET MSG command.

Notes

For detailed information on setting the size of the calculator cache, see the Database Administrator's Guide.

Example

If the essbase.cfg file contains the following settings:

CALCCACHEHIGH  1000000
CALCCACHEDEFAULT  300000
CALCCACHELOW  200000

then:

 
SET CACHE HIGH;

sets a calculator cache of up to 1,000,000 bytes for the duration of the calculation script.

 
SET CACHE DEFAULT;

sets a calculator cache of up to 300,000 bytes for the duration of the calculation script.

 
SET CACHE LOW;

sets a calculator cache of up to 200,000 bytes for the duration of the calculation script.

 
SET CACHE ALL;
SET CACHE LOW;

sets a calculator cache of 200,000 bytes to be used even when you do not calculate at least one, full sparse dimension.

 
SET CACHE OFF;

means that Analytic Services does not use a calculator cache.

See Also

CALCCACHE TRUE | FALSE (essbase.cfg file setting)
CALCCACHEHIGH | DEFAULT | LOW (essbase.cfg file setting)
SET MSG (calculation script)
Set Commands

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