1. Calculation and Query Reference for Oracle Essbase
  2. Calculation Commands
  3. Calculation Command List
  4. SET CACHE

SET CACHE

The SET CACHE calculation command specifies the size of the calculator cache. Essbase uses the calculator cache to create and track data blocks during calculation.

Syntax

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

Parameters

HIGH, DEFAULT, and LOW

Levels defining the size of the calculator cache. You set the values of HIGH, DEFAULT and LOW in the Essbase configuration settings. If you do not set the value of DEFAULT, 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 configuration.

The level you choose depends on the amount of memory your system has available and the configuration of your database.

You can specify whether, by default, Essbase uses a calculator cache using the CALCCACHE TRUE | FALSE configuration setting. 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 configuration 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;

Specifies that Essbase does not use a calculator cache.