dt_mer_server

Daylight v4.9
Release Date: 1 February 2008

Name

dt_mer_server - connect to a server

Generic Prototype

dt_mer_server(dt_String, dt_String, dt_String, dt_String, dt_Integer *)
=> dt_Handle

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 Prototype

include 'dt_f_merlin.inc'

integer*4 dt_f_mer_server(host, service, userid, passwd, isnew)

character*() host
character*() service
character*() userid
character*() passwd
integer*4 isnew

Description

Connects 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 "192.9.11.6").

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 Value

Returns a handle for a server object, or the NULL_OB if an error is encountered. Reasons that the connection may fail include: