Onix Text Retrieval Toolkit
API Reference

API
Function List
Topical List

Main Index

Introduction
Calling Sequences
Query Processing
Relevancy Ranking
Data Types
Error Handling
   
Support
   
Lextek Products
Onix Text Retrieval Engine
Lextek Document Profiler & Categorizer
Brevity Document Summarizer
RouteX Routing Engine
Language Identifier

ixSetLocationForTemporaryFiles

Name

ixSetLocationForTemporaryFiles

Synopsis

void ixSetLocationForTemporaryFiles(OnixFileSpecT PathName)

Arguments

PathName: The path to the location where you would like the temporary files stored.

Returns

Nothing.

Description

During the indexing process, Onix generates a number of temporary files. These files can grow to be of considerable size approaching or surpassing the size of the text being indexed. By default, these temporary files are stored in the default location for temporary files specified by the operating system. However, often it is desirable to have these temporary files stored elsewhere either for reasons of efficiency or disk space. (For example, if you want to use a secondary drive which has plenty of disk space available for your temporary files.)

To specify where you would like your temporary files stored, simply pass in the path to ixSetLocationForTemporaryFiles(). This path must be the fully qualified path meaning that any directory separator characters must be present allowing the file name to simply be appended to the location you specified.

For example on a Windows system, "C:\Temp\" will work whereas C:\Temp" will not as the first when a temporary file is generated will create "C:\Temp\TempFile1.tmp" where the second generates "C:\TempTempFile1.tmp". This holds for Unix, Mac, BeOS and other systems.

To revert to using the location specified by the OS, simply pass in a zero length path ("") or NULL and future temporary files will be stored in the location specified by the operating system.

Be aware, to make this change and remain thread safe, you will need to make sure that all indexing and searching processes are competed before making a change.

See Also

Temporary Files
ixGetLocationForTemporaryFiles, ixGetTempDiskSpaceUsage