NAME

tisam_SetVolume - sets the thread-specific volume name

SYNOPSIS

void tisam_SetVolume (IN char ∗ volumeName)

PARAMETERS

volumeName Specifies the volume in which to store data and indices. 

DESCRIPTION

The tisam_SetVolume function sets the thread-specific volume where data and indices created by the calling thread will be stored. When a T-ISAM application is initialized, the ENCINA_TISAM_VOL environment variable is checked to determine the name of the default volume used for all data and indices created by all threads in that process. This volume name for the entire process can be set only at initialization time, and then only by using this environment variable. 

The volume name is consulted during calls to isbuild and isaddindex. Subsequent calls to isbuild and isaddindex on behalf of a thread that calls the tisam_SetVolume function use the volume specified in that call; all other threads continue to use the process-global default volume. If the ENCINA_TISAM_VOL environment variable was not set when the application was initialized and isbuild and isaddindex are used before the tisam_SetVolume function is called, the error EBADVOL will be returned. The volume specified must be known to the SFS server being used; if it is not, the error EBADVOL is returned by isbuild or isaddindex. 

NOTES

This function may also be called using the name issetvol. 

RELATED INFORMATION

Encina SFS Programming Guide

  —  March 1997