


bsp_get_tag(3)          BSPlib FUNCTIONS           bsp_get_tag(3)



NAME
     bsp_get_tag - check the tag on a BSMP packet.


C SYNOPSIS
     #include "bsp.h"

     void bsp_get_tag(int *_s_t_a_t_u_s, void *_t_a_g);

FORTRAN SYNOPSIS
     SUBROUTINE  bspgettag(_s_t_a_t_u_s,_t_a_g)
     INTEGER, intent(OUT) ::_s_t_a_t_u_s
     <TYPE>,  intent(OUT) ::_t_a_g


DESCRIPTION
     To receive a message, the user  should  use  the  procedures
     bsp_get_tag  and  bsp_move(3).  The  effect of the operation
     bsp_get_tag is that the argument _s_t_a_t_u_s  has  the  value  -1
     assigned  to  it  if  system  buffer is empty.  Otherwise it
     becomes the length of the payload of the  first  message  in
     the buffer. This length can be used to allocate an appropri-
     ately sized data structure for  copying  the  payload  using
     bsp_move(3).  The  memory  referenced by _t_a_g is unchanged if
     the system buffer is empty. Otherwise it is assigned the tag
     of the first message in the buffer.


SEE ALSO
     bsmp(3)  ,bsp_send(3),   bsp_set_tagsize(3),   bsp_qsize(3),
     bsp_move(3), bsp_hpmove(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.


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


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                    1



