Release Date: 1 February 2008
Namedt_hold - mark an object as held
Generic Prototypedt_hold(dt_Handle, dt_String) => dt_Boolean
C Prototype#include "dt_thor.h"
dt_Boolean dt_hold(dt_Handle object, dt_Integer alen, dt_String auth_pw)
FORTRAN Prototypeinclude 'dt_f_thor.inc'
logical dt_f_hold(object, auth_pw)
DescriptionMarks the specified object as "held", so that it will be kept even if no client is using it. The 'object' may be a THOR or Merlin database or a Merlin column.
For a Merlin database (pool), this means the database will be retained in memory. For a Merlin column, it means the column will be retained (columns are normally shared among clients) for faster startup.
For a THOR database, it means the database's files will remain open, and if the database is partially or fully cached (see dt_cache(3) and dt_cachecontrol(3)), the cached data will remain in memory.
The password 'auth_pw' is that of user "thor", and must be supplied even if the client is connected as user "thor".
Note that this is an operation to manage the Merlin servers use of memory, as opposed to an object operation. Because of this, the authorization password for user "thor" rather than the database's executive password.
Return ValueReturns the success (TRUE) or failure (FALSE) of the operation.
Related Topicsdt_database(3) dt_getdatabases(3) dt_getpasswords(3) dt_getsearchpath(3) dt_getusers(3) dt_isheld(3) dt_isopen(3) dt_ispublic(3) dt_open(3) dt_ping(3) dt_release(3) dt_server(3) dt_setpassword(3) dt_setsearchpath(3)