The Main Manual Page Dynamic API Documentation CD-ROM API Documentation About Onix Types About Onix Errors Onix's Web Site at Lextek International Lextek International Onix Full Text Indexing and Retrieval Toolkit

ixEndOptimization

NAME

ixEndOptimization -- End optimizations started by a call to ixOptimizeIndex.

SYNOPSIS

void ixEndOptimization(OnixIndexManagerT IndexManager, char *FileName, ULongT Flags, StatusCodeT *Status);

ARGUMENTS

IndexManager -- An index manager which was created by a call to ixCreateIndexManager. The index has to have an opened index associated with it (via a call to ixOpenIndex).

FileName -- The filename of the partition if this is a distributed index (NULL otherwise).

Flags -- Flags used to change the behavior of ixEndOptimization.

*Status -- A pointer to a StatusCodeT.  (This is where any errors will be reported.)

RETURNS

Nothing.

DESCRIPTION

ixEndOptimization ends the optimization of the index which was started by ixOptimizeIndex. ixEndOptimization makes the final changes to the index integrating the new optimized data. Typically, ixEndOptimization runs really fast in comparison to the actual optimization process. Most of the time is spent in actually coping the optimized data. During the period that ixEndOptimization is called, you should not search the index or otherwise access it via the same or other processes. If the index is a distributed index, you can reduce the amount of time that the index is occupied by ixEndOptimization by copying the main header for the index (the index you specify when you open it with ixOpenIndex) to another file and then optimizing that index. When complete copy it over the original index which should only take 10-15ms depending on your OS and drive speed.

When ixEndOptimization is complete, it is important to close and reopen the index in all processes that are accessing it. This will ensure that all data that is loaded in the various index readers is fully synched with the contents of the index and the index's various headers.

SEE ALSO

ixOptimizeIndex