assetserveropt(3x)

NAME
     assetserveropt, asgetserveropt, asdfltserveropt - set/retrieve server
     options

SYNOPSIS
     #include <arraysvcs.h>

     int assetserveropt(asserver_t Server, int OptName,
                        const void *OptVal, int OptLen);

     int asgetserveropt(asserver_t Server, int OptName,
                        void *OptVal, int OptLen);

     int asdfltserveropt(int OptName, void *OptVal, int OptLen);

DESCRIPTION
     asgetserveropt and assetserveropt are used to manipulate options
     associated with the server token Server.  asdfltserveropt is used to
     retrieve the standard default value for those options when a new server
     token is created using asopenserver(3X).  The particular option to be
     manipulated is specified by OptName, which may be one of the following
     values (defined in <arraysvcs.h>):

     AS_SO_TIMEOUT
            Sets or retrieves the timeout value (in seconds) for a response to
            a request made to the array services daemon associated with the
            server token.  The timeout value is of type "int".

     AS_SO_CTIMEOUT
            Sets or retrieves the timeout value (in seconds) for establishing
            an initial connection with the array services daemon associated
            with the server token.  The timeout value is of type "int".

     AS_SO_FORWARD
            Sets or retrieves the state of the forwarding flag associated with
            the server token.  If the flag is non-zero, then any requests made
            with the token will be forwarded to the server associated with the
            token via the array services daemon at the default port on the
            local machine.  If the flag is zero, requests are sent directly to
            the server associated with the token.  The default setting of this
            flag is 0 unless the environment variable ARRAYD_FORWARD had a
            value beginning with the letter "Y" (as in "yes", in either upper
            or lower case) at the time the token was created.  The value of
            the flag is of type "int".

     AS_SO_LOCALKEY
            Sets or retrieves the authentication key that is used for any
            messages sent to the array services daemon associated with the
            server token.  The default value of this key is obtained from the
            environment variable ARRAYD_LOCALKEY if it exists, or otherwise is
            set to 0.  The key is of type askey_t.
     AS_SO_REMOTEKEY
            Sets or retrieves the authentication key that is used for any
            messages received from the array services daemon associated with
            the server token.  The default value of this key is obtained from
            the environment variable ARRAYD_REMOTEKEY if it exists, or
            otherwise is set to 0.  The key is of type askey_t.

     AS_SO_PORTNUM
            (Only valid with asdfltserveropt).  Retrieves the port number of
            the default array services daemon.  This value is obtained from
            the environment variable ARRAYD_PORT if it exists, otherwise the
            port number associated with the service "sgi-arrayd" is used.

     AS_SO_HOSTNAME
            (Only valid with asdfltserveropt).  Retrieves the hostname of the
            default array services daemon.  This value is obtained from the
            environment variable ARRAYD if it exists, otherwise "localhost" is
            used.


     The parameters OptVal and OptLen are used to access option values for
     assetserveropt.  For asgetserveropt and asdfltserveropt, they identify a
     buffer in which the value for the requested option is to be returned.
     For those functions, OptLen is a value-result parameter, initially
     containing the size in bytes of the buffer pointed to by OptVal, and
     modified on return to indicate the actual size of the value returned.

     If any of these functions is unsuccessful, -1 is returned and
     aserrorcode(3X) will be set appropriately.

NOTES
     These functions 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
     ascloseserver(3X), aserrorcode(3X), asopenserver(3X), array_services(5).

DIAGNOSTICS
     Both functions return 0 if successful, -1 if not.  If unsuccessful,
     aserrorcode(3X) will be set appropriately.