Daylight v4.9
Release Date: 1 February 2008

Object Synopsis

server -- object representing a connection to a THOR server

Description

A server object represents a TCP/IP connection from a client program to a THOR server. It is also the ultimate ancestor (parent) of all THOR-related objects, i.e. database, datatree, datatype, dataitem, and datafield objects.

Because a server object represents an external entity (the thorserver program, running independently), it has properties that persist even after the object is deallocated (e.g. passwords). Furthermore, those properties are shared among all of the clients attached to the server; if one client changes a property, it is changed for all clients.

If the THOR server program "crashes" or is killed, the server object remains as a valid object, but any attempts to communicate with the server will result in a "Lost connection" error message.

If the merserver object is deallocated, then all child objects (datatree, datatype, etc.) are also deallocated. The server detects disconnections, and deallocates any resources the client might be using (open databases)

Related Topics

database(3ob) datatype(3ob) merserver(3ob)

dt_set_server_timeout(3) dt_setinteger(3) dt_typename(3) dt_mer_superselect2name(3) dt_sethandle(3) dt_mer_action2name(3) dt_integer(3) dt_server(3) dt_thor_createdb(3) dt_mer_nfunctions(3) dt_getdatabases(3) dt_setsearchpath(3) dt_mer_function2name(3) dt_real(3) dt_handle(3) dt_count(3) dt_mer_nsimilars(3) dt_getusers(3) dt_mer_sort2name(3) dt_string(3) dt_setstring(3) dt_open(3) dt_thor_server(3) dt_setadjunct(3) dt_mer_search2name(3) dt_ping(3) dt_stream(3) dt_stringvalue(3) dt_thor_destroy(3) dt_boolean(3) dt_getpasswords(3) dt_setreal(3) dt_mer_subselect2name(3) dt_proptype(3) dt_dealloc(3) dt_setpassword(3) dt_mer_nsubselects(3) dt_setboolean(3) dt_parent(3) dt_adjunct(3) dt_setmessage(3) dt_mer_similar2name(3) dt_mer_nsuperselects(3) dt_getsearchpath(3) dt_info(3) dt_mer_nsearches(3) dt_evict(3) dt_mer_nsorts(3) dt_exists(3) dt_type(3) dt_propnames(3) dt_appendstring(3) dt_isopen(3)