asallocash(3x)

NAME
     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 session 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 specific 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 session handle if
     successful.  If unsuccessful, -1LL is returned and aserrorcode is set
     appropriately.