BEGININCBUILDDIM

Prepares Essbase Services for deferred-restructure dimension building commands.

Syntax

BEGININCBUILDDIM

Notes

Deferred-restructure dimension builds have also been called incremental dimension builds. This command works in conjunction with the ENDINCBUILDDIM command to group together one or more INCBUILDDIM statements.

This command locks the outline file. If the outline file is already locked, this command returns an error.

This command copies the outline file (.OTL) to a backup file name (.OTN). Subsequent INCBUILDDIM commands operate on the .OTN file. See the Oracle Essbase Database Administrator's Guide for more information about restructuring and backup files.

BEGININCBUILDDIM starts a programming block; ENDINCBUILDDIM ends the programming block.

Example

To build the dimensions specified in GENREF.RUL and LEVELMUL.RUL, discard all data, and save the new outline after the dimension builds are complete:

BEGININCBUILDDIM;
INCBUILDDIM 2 "GENREF.RUL" 2 "GENREF.TXT" 4 "ERR.OUT" 1;
INCBUILDDIM 2 "LEVELMUL.RUL" 2 "LEVELMUL.TXT" 4 "ERR.OUT" 1;
ENDINCBUILDDIM 4;