.PVM.notify {rpvm} | R Documentation |
Request notification of PVM event such as host failure.
.PVM.notify (msgtag, what = c("ExitTask", "DeleteHost", "AddHost"), par = 0)
msgtag |
message tag to be used in notification |
what |
a character string specifying the type of event to trigger
the notification, must be one of |
par |
additional parameter, if |
The routine .PVM.notify
requests PVM to notify the caller on
detecting certain events. One or more notify messages (see below) are
sent by PVM back to the calling task. The messages have tag
msgtag
supplied to notify.
The notification messages have the following format:
"ExitTask"
One notify message for each task id requested.
The message body contains a single integer task id of exited task.
"DeleteHost"
One notify message for each host id
requested. The message body contains a single integer host
(pvmd) id of exited pvmd.
"AddHost"
par
notify messages are sent, one
each time the local pvmd's host table is updated. The message is a
vector of ids of new pvmds and can be unpacked by
.PVM.upkintvec
. The counter of "AddHost"
messages yet to be sent is replaced by successive calls to
.PVM.notify
. Specifying par
= -1 turns on
"AddHost"
messages until a future notify; 0 disables them.
The calling task is responsible for receiving messages with the specified tag and taking appropriate action. This feature makes PVM fault tolerant.
Status code returned by the routine. -1 if there was an error.
Na (Michael) Li nali@umn.edu and A.J. Rossini rossini@u.washington.edu
PVM documentation
## Not run: .PVM.notify (msgtag = 999, what = "Exit", tids)