NAME

pvm_getmwid, pvm_setmwid − Get or set wait ID of a message. 
 

SYNOPSIS

Cint info = pvm_getmwid( int bufid )
int info = pvm_setmwid( int bufid, int waitid )
 
FortranNot Available

PARAMETERS

bufidMessage buffer identifier. 

waitidWait identifier number. 
 

DESCRIPTION

A wait identifier is part of a message (like the source, destination, tag and body).  It is used to match a reply to the corresponding request. 
 
The default wait ID for a message is zero (none).
 
pvm_getmwid returns the wait ID associated with a message buffer, or a negative error code.
 
pvm_setmwid assigns a new wait ID to a message buffer. It returns PvmOk unless an error occurs.
 

EXAMPLES

int src, tag;
 pvm_recv(-1, -1);
/∗ ... process, compose reply message ∗/
pvm_setmwid(pvm_getsbuf(), pvm_getmwid(pvm_getrbuf()));
pvm_bufinfo(pvm_getrbuf(), (int ∗)0, &tag, &src);
pvm_send(src, tag);
 

ERRORS

The following error conditions can be returned by pvm_getmwid or pvm_setmwid:

PvmBadParam
Invalid value for bufid argument. 

PvmNoSuchBuf
Message buffer bufid doesn’t exist. 

SEE ALSO

pvm_bufinfo(3PVM)

  —  18 May, 1994