NAME

     bsp_get_tag - check the tag on a BSMP packet.

C SYNOPSIS

     #include "bsp.h"

     void bsp_get_tag(int *status, void *tag);

FORTRAN SYNOPSIS

     SUBROUTINE  bspgettag(status,tag)
     INTEGER, intent(OUT) ::status
     <TYPE>,  intent(OUT) ::tag

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 status  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 tag 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)

     ``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.

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