SETRBUF(3PVM) PVM Version 3.4 SETRBUF(3PVM)NAME
pvm_setrbuf - Switches the active receive buffer and saves the previous
buffer.
SYNOPSIS
C int oldbuf = pvm_setrbuf( int bufid )
Fortran call pvmfsetrbuf( bufid, oldbuf )
PARAMETERS
bufid Integer specifying the message buffer identifier for the new
active receive buffer.
oldbuf Integer returning the message buffer identifier for the previā
ous active receive buffer.
DESCRIPTION
The routine pvm_setrbuf switches the active receive buffer to bufid and
saves the previous active receive buffer oldbuf. If bufid is set to 0
then the present active receive buffer is saved and no active receive
buffer exists.
A successful receive automatically creates a new active receive buffer.
If a previous receive has not been unpacked and needs to be saved for
later, then the previous bufid can be saved and reset later to the
active buffer for unpacking.
The routine is required when managing multiple message buffers. For
example switching back and forth between two buffers. One buffer could
be used to send information to a graphical interface while a second
buffer could be used send data to other tasks in the application.
EXAMPLES
C:
rbuf1 = pvm_setrbuf( rbuf2 );
Fortran:
CALL PVMFSETRBUF( NEWBUF, OLDBUF )
ERRORS
These error conditions can be returned by pvm_setrbuf
PvmBadParam
giving an invalid bufid.
PvmNoSuchBuf
switching to a non-existent message buffer.
SEE ALSOpvm_setsbuf(3PVM)
30 August, 1993 SETRBUF(3PVM)