ENDINCBUILDDIM

Ends the programming block started by BEGININCBUILDDIM and restructures the database after one or more deferred-restructure dimension-building (INCBUILDDIM) commands. Deferred restructure dimension builds have also been called incremental dimension builds.

Syntax

ENDINCBUILDDIM preserve
ParameterDescription

preserve

Specifies whether to preserve existing data in the database. This parameter is required. Values:

1 - Preserves all existing data blocks. 2 - Preserves existing level 0 data. 3 - Preserves existing input-level data. 4 - Discards all existing data.

Notes

This command works in conjunction with the BEGININCBUILDDIM command to group together one or more INCBUILDDIM statements.

This command restructures the database according to the dimension changes that occur as a result of the INCBUILDDIM commands.

This command preserves existing data according to the preserve option.

This command unlocks the outline once restructuring is complete, and overwrites the original .OTL file with the newly modified .OTN file. See BEGININCBUILDDIM for information.

If one or more of the INCBUILDDIM commands that precede the ENDINCBUILDDIM command fails, ENDINCBUILDDIM still restructures the database.

WARNING: If you don't issue an ENDINCBUILDDIM command after a BEGININCBUILDDIM command and one or more INCBUILDDIM commands, the changes made to the .OTN file are not copied to the database outline (.OTL) file, and the data is not restructured.

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;

See Also