SET CACHE

Specifies the size of the calculator cache.

Syntax

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

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, Essbase uses a default value of 200,000 bytes. The maximum calculator cache size that you can specify is 200,000,000 bytes.

OFF

Essbase does not use the calculator cache.

ALL

Essbase uses the calculator cache, even when you do not calculate at least one full sparse dimension.

Caution!

Forcing use of the calculator cache inside a FIXPARALLEL statement could increase calculation time.

Notes

Essbase 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 Oracle Essbase Database Administrator's Guide.

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

Essbase uses the calculator cache providing that:

  • Your database has at least two sparse dimensions.

  • You calculate at least one, full sparse dimension (unless you specify the CALCCACHE ALL option).

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

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

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;

Ssets 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;

Specifies that Essbase does not use a calculator cache.

See Also