Release Date: 1 February 2008
Namedt_release - release an object from a server's retained list
Generic Prototypedt_release(dt_Handle, dt_String) => dt_Boolean
C Prototype#include "dt_thor.h"
dt_Boolean dt_release(dt_Handle object, dt_Integer alen, dt_String auth_pw)
FORTRAN Prototypeinclude 'dt_f_thor.inc'
logical dt_f_release(object, auth_pw)
DescriptionUnmarks the specified object as held, so that it will be closed or deleted from the server's memory after the last client closes the object.
The password 'auth_pw' is that of user "thor", and must be supplied even if the client is connected as user "thor". 'object' may be a database or column.
Note that this is an operation to manage the server's use of memory, as opposed to a object operation. Hence the authorization password for user "thor" rather than the database 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_hold(3) dt_isheld(3) dt_isopen(3) dt_ispublic(3) dt_open(3) dt_ping(3) dt_server(3) dt_setpassword(3) dt_setsearchpath(3)