


bsp_qsize(3)            BSPlib FUNCTIONS             bsp_qsize(3)



NAME
     bsp_qsize - checks to see how many BSMP packets arrived.


C SYNOPSIS
     #include "bsp.h"

     void  bsp_qsize(int *_p_a_c_k_e_t_s, int *_a_c_c_u_m__n_b_y_t_e_s);

FORTRAN SYNOPSIS
     SUBROUTINE  bspqsize(_p_a_c_k_e_t_s,_a_c_c_u_m__n_b_y_t_e_s)
     INTEGER, intent(OUT) ::_p_a_c_k_e_t_s,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)

     ``_B_S_P_l_i_b: _T_h_e _B_S_P _P_r_o_g_r_a_m_m_i_n_g _L_i_b_r_a_r_y'' 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
     _h_t_t_p://_w_w_w._b_s_p-_w_o_r_l_d_w_i_d_e._o_r_g 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  _b_s_p_l_i_b-
     _b_u_g_s@_c_o_m_l_a_b._o_x._a_c._u_k





Oxford BSP Toolset  Last change: 1.4 25/9/98                    1






bsp_qsize(3)            BSPlib FUNCTIONS             bsp_qsize(3)



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



















































Oxford BSP Toolset  Last change: 1.4 25/9/98                    2



