Daylight v4.9
Release Date: 1 February 2008

Object Synopsis

merserver -- object representing a connection to a Merlin server

Description

A merserver object represents a TCP/IP connection from a client program to a Merlin server. It is also the ultimate ancestor (parent) of all Merlin-related objects, i.e. pool, hitlist, column, datatype, and fieldtype objects.

Because a merserver object represents an external entity (the merlinserver 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 Merlin server program "crashes" or is killed, the merserver 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 (pool, column, hitlist, etc.) are also deallocated. The server detects disconnections, and deallocates any resources the client might be using (open pools, columns, hitlists).

Related Topics

pool(3ob) datatype(3ob) server(3ob)

dt_setinteger(3) dt_typename(3) dt_sethandle(3) dt_mer_progob2name(3) dt_integer(3) dt_continue(3) dt_mer_server(3) dt_real(3) dt_handle(3) dt_count(3) dt_string(3) dt_setstring(3) dt_open(3) dt_setadjunct(3) dt_stream(3) dt_mer_progob_compareparams(3) dt_boolean(3) dt_mer_nactions(3) dt_setreal(3) dt_proptype(3) dt_dealloc(3) dt_mer_progob_compute(3) dt_mer_progob_computeparams(3) dt_mer_nprogobs(3) dt_setboolean(3) dt_mer_progob_compare(3) dt_adjunct(3) dt_abort(3) dt_done_when(3) dt_type(3) dt_propnames(3) dt_appendstring(3)