asallocash - allocate a global array session handle


SYNOPSIS

       #include <sys/types.h>
       #include <arraysvcs.h>

       ash_t asallocash(asserver_t server, const char *array);


DESCRIPTION

       The  asallocash  function allocates a global array session
       handle in the specified array.  The resulting  array  ses­
       sion  handle  is guaranteed to be unique across all of the
       machines in that array.

       The server parameter specifies an  optional  array  server
       token,  which  can be used to direct the request to a spe­
       cific  array  services  daemon.   If  NULL  is   specified
       instead,  the  request  will  be  processed by the default
       array services daemon (see array(1) for  more  information
       on  how  the  default  array services daemon is selected).
       For more details on creating an array  server  token,  see
       asopenserver(3X).

       The  array parameter specifies the name of the array as an
       ordinary character string.  If NULL is specified  instead,
       the  array session handle will be allocated in the default
       array of the array services daemon.


NOTES

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


SEE ALSO

       setash(2),       asashisglobal(3X),       aserrorcode(3X),
       asopenserver(3X), array_sessions(5).


DIAGNOSTICS

       asallocash  returns  the newly allocated global array ses­
       sion handle  if  successful.   If  unsuccessful,  -1LL  is
       returned and aserrorcode is set appropriately.


Man(1) output converted with man2html