Direct Access Transport Library Functions    datsrqsetlw(3DAT)



NAME
     datsrqsetlw - set low watermark on shared receive queue

SYNOPSIS
     cc [ flag... ] file... -ldat [ library... ]
     #include 

     DATRETURN
         datsrqsetlw (
             IN      DATSRQHANDLE      srqhandle,
             IN      DATCOUNT           lowwatermark
         )


PARAMETERS
     srqhandle       A  handle  for  an  instance  of  a  Shared
                      Receive Queue.


     lowwatermark    The low watermark for the  number  of  Recv
                      buffers on SRQ.


DESCRIPTION
     The datsrqsetlw() function sets the low  watermark  value
     for  the SRQ and arms the SRQ for generating an asynchronous
     event for the low watermark. An asynchronous event  will  be
     generated when the number of buffers on the SRQ is below the
     low watermark for the first time. This can occur during  the
     current  call  or  when an associated EP takes a buffer from
     the SRQ.


     The asynchronous event will be generated only once per  set-
     ting  of  the  low watermark. Once an event is generated, no
     new asynchronous events for the number of buffers inthe  SRQ
     below the specified value will be generated until the SRQ is
     again set for the Low Watermark. If the  Consumer  is  again
     interested  in  the  event,  the Consumer should set the low
     watermark again.

RETURN VALUES
     DATSUCES                The operation was successful.


     DATINVALIDHANDLE         The  srqhandle  argument  is  an
                                invalid DAT handle.


     DATINVALIDPARAMETER      Invalid parameter; the  value  of
                                lowwatermark   is   exceeds  the
                                value of maxrecvdtos.



SunOS 5.11          Last change: 16 Jul 2004                    1






Direct Access Transport Library Functions    datsrqsetlw(3DAT)



     DATMODELNOTSUPORTED    The requested Model was not  sup-
                                ported  by the Provider. The Pro-
                                vider does not  support  SRQ  Low
                                Watermark.


USAGE
     Upon receiving the asynchronous event for the SRQ low water-
     mark,  the Consumer can replenish Recv buffers on the SRQ or
     take any other action that is appropriate.


     Regardless of whether an  asynchronous  event  for  the  low
     watermark  has  been  generated, this operation will set the
     generation of  an  asynchronous  event  with  the  Consumer-
     provided low watermark value. If the new low watermark value
     is below the current number of free Receive DTOs  posted  to
     the  SRQ,  an  asynchronous  event will be generated immedi-
     ately. Otherwise the  old  low  watermark  value  is  simply
     replaced with the new one.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Standard: uDAPL, 1.2        
    
     MT-Level                     Unsafe                      
    


SEE ALSO
     datsrqcreate(3DAT),                    datsrqfree(3DAT),
     datsrqpostrecv(3DAT),                datsrqquery(3DAT),
     datsrqresize(3DAT), libdat(3LIB), attributes(5)















SunOS 5.11          Last change: 16 Jul 2004                    2