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

NAME

6       pvm_setsbuf - Switches the active send buffer.
7
8

SYNOPSIS

10       C    int oldbuf = pvm_setsbuf( int bufid )
11
12       Fortran   call pvmfsetsbuf( bufid, oldbuf )
13
14

PARAMETERS

16       bufid   Integer  the  message buffer identifier for the new active send
17               buffer.  A value of 0 indicates the default receive buffer.
18
19       oldbuf  Integer returning the message buffer identifier for the  previ‐
20               ous active send buffer.
21
22

DESCRIPTION

24       The  routine  pvm_setsbuf  switches the active send buffer to bufid and
25       saves the previous active send buffer oldbuf.  If bufid  is  set  to  0
26       then  the present active send buffer is saved and no active send buffer
27       exists.
28
29       The routine is required when managing multiple  message  buffers.   For
30       example switching back and forth between two buffers.  One buffer could
31       be used to send information to a graphical  interface  while  a  second
32       buffer could be used send data to other tasks in the application.
33
34

EXAMPLES

36       C:
37            sbuf1 = pvm_setsbuf( sbuf2 );
38       Fortran:
39            CALL PVMFSETSBUF( NEWBUF, OLDBUF )
40
41

ERRORS

43       These error conditions can be returned by pvm_setsbuf
44
45       PvmBadParam
46              giving an invalid bufid.
47
48       PvmNoSuchBuf
49              switching to a non-existent message buffer.
50

SEE ALSO

52       pvm_setrbuf(3PVM)
53
54
55
56                                30 August, 1993                  SETSBUF(3PVM)