bsp_qsize(3)

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 process in the previous superstep and have not yet been consumed 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 previous superstep. The function also returns the accumulated size of all the payloads of the unconsumed messages. This operation is intended to help the user to allocate an appropriately 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 system 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