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  previous  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 ALSO

       pvm_setsbuf(3PVM)

                                         30 August, 1993                            SETRBUF(3PVM)