asopenserver(3x)

NAME
     asopenserver, ascloseserver - create or destroy an array server token

SYNOPSIS
     #include <arraysvcs.h>

     asserver_t asopenserver(const char *ServerName, int PortNumber);
     void ascloseserver(asserver_t Server);

DESCRIPTION
     The asopenserver function is used to create an "array server token".
     This token can be used with other libarray functions to direct array
     services requests to a specific array services daemon.  The ServerName
     parameter specifies the hostname of the machine to which array services
     requests made with this token should be directed.  If NULL is specified,
     the request will be processed by the default array services host.  The
     PortNumber parameter specifies the network port number of the array
     services daemon on the specified machine.  If -1 is specified instead,
     the default port number will be used.  See array(1) for more information
     on how the default array services host and port number are determined.

     The ascloseserver function should be used to destroy the array server
     token specified by Server when it is no longer needed.  This will release
     any resources that it may be using.

NOTES
     asopenserver and ascloseserver are found in the library "libarray.so",
     and will be loaded if the option "-larray" is used with cc(1) or ld(1).

SEE ALSO
     aserrorcode(3X), assetserveropt(3X), array_sessions(5).

DIAGNOSTICS
     asopenserver returns a non-zero array server token if successful, or NULL
     if not.  If unsuccessful, aserrorcode(3X) will be set appropriately.