Name

Generic Prototype

C Prototype

dt_Handle dt_thor_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

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

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

Description

The parameter 'host' is a hostname or network address ("day", or "192.9.11.6").

The parameter 'service' name 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, or are supplied by a NIS (Network Information Services) server. Typical values are "thor" and "merlin". To override values listed in /etc/services (or if /etc/services is not available), a port may be substituted (eg. "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

- no server is running on the specified host,
- the network between the client and server is not functioning,
- the userid and password combination are invalid for the server,
- the client machine is not authorized to connect to the server,
- all of the server's licenses for connections are in use.

Related Topics