Function:     gds___server

Purpose:      Obtain a GDS server status block pointer, given a set name.

Category:     GDS, SYSTEM

File:         gds___server.c

Author:       J.P. Terlouw

Use:          #include "gds___server.h"
              gdsserver gds___server(char *setname);

Description:  gds___server() obtains a pointer to a structure associated with
              a gds server process. This pointer can subsequently be used in
              calls to gds___srvreq(), gds___srvrcv(), and gds___srvsnd().
              In case of failure NULL is returned. In this case gds___srverr()
              can be called to obtain the error code.

Related docs: gds___srvreq.dc3, gds___srvsnd.dc3, gds___srvrcv.dc3, 
              gds___srvcls.dc3, gds___srvnam.dc3, gds___srverr.dc3.

Updates:      Mar 28, 1995: JPT, Document created.
              May 10, 1995: JPT, Reduced number of I/O's in gds___srvreq.
              Sep  1, 1995: JPT, Fixed inaccessible directory bug.
              Sep 28, 1995: JPT, Translate symbolic links.
              Sep 29, 1995: JPT, Fixed absolute symbolic link bug.
              Sep  2, 1996: JPT, Small code change by KGB.
              Feb 16, 1998: JPT, Forcefully close all sets when fd table full.
              Nov 19, 1998: JPT, Retry in case of bad sockets file.
              Sep 19, 2000: JPT, Check GDS server startup failure.
              May  1, 2007: JPT, Conditional code for Apple Mac included.
              Mar  8, 2011: JPT, Fixed problem with uninitialized st_dev.