sam_set_fs_thresh(3)

NAME
     sam_set_fs_thresh - Sets  file  system  thresholds  for  the
     releaser

SYNOPSIS
     cc [ flag  ... ] file  ... -L/opt/SUNWsamfs/lib  -lsamapi  [library ... ]

     #include "/opt/SUNWsamfs/include/samapi.h"

     int sam_set_fs_thresh(ushort_t eq_number, int min_threshold,
     int max_threshold, int wait_response);

DESCRIPTION
     sam_set_fs_thresh()  sets  the  minimum  (low)  and  maximum
     (high)   thresholds  which  control  the  execution  of  the
     releaser for archived files in the family set  at  equipment
     number eq_number. Reaching the maximum threshold in the fam-
     ily set initiates the releaser, which  releases  file  space
     until  the minimum threshold is reached or no release candi-
     dates exist.

     The call will return immediately after issuing  the  command
     if  zero is specified for wait_response value.  Other values
     for wait_response will give undefined results.

RETURN VALUES
     Upon succesful completion a value of 0 is returned.   Other-
     wise, a value of -1 is returned and errno is set to indicate
     the error.

ERRORS
     sam_set_fs_thresh() fails if one or more  of  the  following
     are true:

     ER_DEVICE_NOT_CORRECT_TYPE
                         The specified eq_number device is not  a
                         family set device.

     ER_FIFO_PATH_LENGTH The path and filename for the FIFO  pipe
                         is too long.

     ER_NO_EQUIP_ORDINAL eq_number is  not  a  defined  equipment
                         number in this configuration.

     ER_NO_MASTER_SHM    No Sun  QFS  or  SAM-QFS  master  shared
                         memory  segment defined.  Check that the
                         Sun QFS  or  SAM-QFS  file  systems  are
                         mounted.

     ER_NO_MASTER_SHM_ATT
                         No Sun  QFS  or  SAM-QFS  master  shared

                         memory  segment  found.   Check that the
                         Sun QFS  or  SAM-QFS  file  systems  are
                         mounted.

     ER_NO_RESPONSE_FIFO Unable to create the response FIFO pipe.

FILES
     mcf                 The configuration file for Sun  QFS  and
                         SAM-QFS file systems.

SEE ALSO
     samu(1M).