1SETRBUF(3PVM)                   PVM Version 3.4                  SETRBUF(3PVM)
2
3
4

NAME

6       pvm_setrbuf - Switches the active receive buffer and saves the previous
7       buffer.
8
9

SYNOPSIS

11       C    int oldbuf = pvm_setrbuf( int bufid )
12
13       Fortran   call pvmfsetrbuf( bufid, oldbuf )
14
15

PARAMETERS

17       bufid   Integer specifying the message buffer identifier  for  the  new
18               active receive buffer.
19
20       oldbuf  Integer  returning the message buffer identifier for the previ‐
21               ous active receive buffer.
22
23

DESCRIPTION

25       The routine pvm_setrbuf switches the active receive buffer to bufid and
26       saves  the previous active receive buffer oldbuf.  If bufid is set to 0
27       then the present active receive buffer is saved and no  active  receive
28       buffer exists.
29
30       A successful receive automatically creates a new active receive buffer.
31       If a previous receive has not been unpacked and needs to be  saved  for
32       later,  then  the  previous  bufid  can be saved and reset later to the
33       active buffer for unpacking.
34
35       The routine is required when managing multiple  message  buffers.   For
36       example switching back and forth between two buffers.  One buffer could
37       be used to send information to a graphical  interface  while  a  second
38       buffer could be used send data to other tasks in the application.
39
40

EXAMPLES

42       C:
43            rbuf1 = pvm_setrbuf( rbuf2 );
44
45       Fortran:
46            CALL PVMFSETRBUF( NEWBUF, OLDBUF )
47
48

ERRORS

50       These error conditions can be returned by pvm_setrbuf
51
52       PvmBadParam
53              giving an invalid bufid.
54
55       PvmNoSuchBuf
56              switching to a non-existent message buffer.
57

SEE ALSO

59       pvm_setsbuf(3PVM)
60
61
62
63                                30 August, 1993                  SETRBUF(3PVM)