Function:     gds___srvreq

Purpose:      Issue a request to a GDS server.

Category:     GDS, SYSTEM

File:         gds___server.c

Author:       J.P. Terlouw

Use:          #include "gds___server.h"
              int gds___srvreq(gdsserver id,
                               void *request,
                               int size,
                               int *nbytes)
   
              id         server 'object', obtained by calling gds___server().
              request    request to server. Requests are defined in gdscom.h.
              size       size of request (bytes).
              nbytes     output argument. If not NULL, it will receive the
                         number of bytes to be read or written as a result
                         of this request.
               
              return value: zero on success; non-zero in case of errors.
              
              A set name in a request must be specified relative to the
              directory in which the set resides.

Related docs: gds___server.dc3, gds___srvsnd.dc3, gds___srvrcv.dc3, 
              gds___srvcls.dc3, gds___srvnam.dc3.

Updates:      Mar 28, 1995: JPT, Document created.
              May 10, 1995: JPT, Reduced number of I/O's.