NAME

     bsp_qsize - checks to see how many BSMP packets arrived.

C SYNOPSIS

     #include "bsp.h"

     void  bsp_qsize(int *packets, int *accum_nbytes);

FORTRAN SYNOPSIS

     SUBROUTINE  bspqsize(packets,accum_nbytes)
     INTEGER, intent(OUT) ::packets,accum_nbytes

DESCRIPTION

     The  function  bsp_qsize(3)  is  an  enquiry  function  that
     returns  the  number of messages that were sent to this pro-
     cess in the previous superstep and have not  yet  been  con-
     sumed  by  a  bsp_move(3). Before any message is consumed by
     bsp_move(3), the total  number  of  messages  received  will
     match those sent by any bsp_send(3) operations in the previ-
     ous superstep.  function also returns the  accumulated  size
     of  all the payloads of the unconsumed messages. This opera-
     tion is intended to help the user to allocate  an  appropri-
     ately  sized  data  structure  to hold all the messages that
     were sent to a process during a superstep.

SEE ALSO

     bsmp(3) ,bsp_send(3), bsp_move(3)

     ``BSPlib: The BSP Programming Library'' Jonathan M. D. Hill,
     Bill  McColl,  Dan  C.  Stefanescu,  Mark W. Goudreau, Kevin
     Lang, Satish B. Rao, , Torsten Suel, Thanasis Tsantilas, and
     Rob  Bisseling.  Parallel  Computing,  to  appear  1998. See
     http://www.bsp-worldwide.org for more details.

NOTES

     i    bsp_qsize(3) returns the number of messages in the sys-
          tem  queue  at  the  point the operation is called; the
          number   returned   therefore   decreases   after   any
          bsp_move(3) operation.

BUGS

     Problems  and  bug  reports  should  be  mailed  to  bsplib-
     bugs@comlab.ox.ac.uk

AUTHORS

     The Oxford BSP Toolset implementation of BSPlib was  written
     by Jonathan.Hill@comlab.ox.ac.uk
     http://www.comlab.ox.ac.uk/oucl/people/jonathan.hill.html