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 *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 appropriately 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