pvm_setmwid(3)

pvm_setmwid3

Get or set wait id of a message. [in version 3.4: relaced by pvm_getminfo and pvm_setminfo]

Usage

C	int info = pvm_getmwid( int bufid )
	int info = pvm_setmwid( int bufid, int waitid )
Fortran	Not Available

Parameters

bufid

Message buffer identifier.

waitid

Wait identifier number.

Overview

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.

Releases

Unchanged in 4 releases since Debian 2.0 (Hamm).

  1. 2.0–3.0

From pvm-dev 3.4.2-8 in Debian 3.0 (Woody). Parsed by carta from the page's man source.