.PVM.probe {rpvm}R Documentation

Probe receive

Description

Checks whether message has arrived.

Usage

.PVM.probe(tid = -1, msgtag = -1)

Arguments

tid the specific tid, -1 is every tid
msgtag tag to use to specific, -1 is all

Details

Checks to see if a message with label msgtag has arrived from tid. If a matching message has arrived, returns a buffer id which can be used in a .PVM.bufinfo call to determine information about the message such as its source and length.

A -1 in msgtag or tid matches anything (wildcard).

After the message has arrived, .PVM.recv must be called before the messag can be unpacked into the user's memory using the unpack routines.

Value

Returns the value of the new active receive buffer id. 0 if the message has not arrived. -1 if there was an error.

Author(s)

Na (Michael) Li nali@umn.edu and A.J. Rossini rossini@u.washington.edu

References

PVM documentation

See Also

.PVM.recv, .PVM.bufinfo

Examples

## To check a node (specified by tid) for a message
## Not run: MsgReady <- .PVM.probe (tid, msgtag)
## To see if any node is sending message with tag thisTag
## Not run: AnyMessageWithThisTag <- .PVM.probe (-1, thisTag)
## To see if node tid is sending any message.
## Not run: AnyMessageFromThisTID <- .PVM.probe (tid, -1)

[Package rpvm version 0.6-2 Index]