SETSBUF (3)
Switches the active send buffer.
SYNOPSIS
B
C int oldbuf = pvm_setsbuf( int bufid )
Fortran call pvmfsetsbuf( bufid, oldbuf )
PARAMETERS
Integer the message buffer identifier for the new active send buffer.
A value of 0 indicates the default receive buffer.
Integer returning the message buffer identifier
for the previous active send buffer.
DESCRIPTION
The routine
pvm_setsbuf
switches the active send buffer to
bufid
and saves the previous active send buffer
oldbuf.
If
bufid
is set to 0 then the present active send buffer
is saved and no active send buffer exists.
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:
sbuf1 = pvm_setsbuf( sbuf2 );
Fortran:
CALL PVMFSETSBUF( NEWBUF, OLDBUF )
ERRORS
These error conditions can be returned by
pvm_setsbuf
switching to a non-existent message buffer.
SEE ALSO
|