Release Date: 1 February 2008
Namedt_mer_server - connect to a server
Generic Prototypedt_mer_server(dt_String, dt_String, dt_String, dt_String, dt_Integer *)
C Prototype#include "dt_merlin.h"
dt_Handle dt_mer_server(dt_Integer hlen, dt_String host, dt_Integer slen, dt_String service, dt_Integer ulen, dt_String userid, dt_Integer plen, dt_String passwd, dt_Integer *isnew)
FORTRAN Prototypeinclude 'dt_f_merlin.inc'
integer*4 dt_f_mer_server(host, service, userid, passwd, isnew)
DescriptionConnects to a server. Returns a server object (TYP_MERSERVER). If the connection already exists, returns the original handle allocated for the server.
The parameter 'host' is a hostname or network address ("day", or "18.104.22.168").
The parameter 'service' names the service (IPC port address) at which the server listens for connections on the host machine. On UNIX machines, these services are listed in the file /etc/services. Typical values are "thor" and "merlin". To override values listed in /etc/services (or if /etc/services is not available), a service name and port may be substituted (eg. "thor.5555").
The parameters 'userid' and 'password' are used to authenticate the identity of the user making the connection.
The parameter 'isnew' indicates whether the returned handle represents a newly-allocated server connection, or represents an existing connection. If 'isnew' if FALSE, the client was already connected to the specified server and the handle returned represents an object which was allocated by a previous call to this function.
Return ValueReturns a handle for a server object, or the NULL_OB if an error is encountered. Reasons that the connection may fail include:
- that there is no server running on the specified host,
Related Topicsdt_ping(3) dt_server(3)