PVM.group {rpvm}R Documentation

Join or leave a names group

Description

Enrolls or unenrolls the calling process to a named group.

Usage

.PVM.joingroup (group)
.PVM.lvgroup (group)

Arguments

group a character string naming the group

Details

.PVM.joingroup enrolls the calling task in the group named group and returns the instance number (inum) this task in this group.

Instance numbers start at 0 and count up. When using groups a (group, inum) pair uniquely identifies a PVM process. If a task leaves a group by calling .PVM.lvgroup and later rejoins the same group, the task is not guaranteed to get the same instance number. PVM attempts to reuse old instance numbers, so when a task joins a group it will get the lowest available instance number. A task can be a member of multiple groups simultaneously.

.PVM.lvgroup unenrolls the calling task from the group named group.

Value

.PVM.joingroup returns the instance number (rank) of the the process in the group.
.PVM.lvgroup returns no value.

Note

If the process fails to join a group with the following message, libpvm [t40002]: gs_getgstid() failed to start group server: No such file It means pvmd cannot find the executable pvmgs, put its path to the ep= option of the host file.

Author(s)

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

References

PVM documentation

See Also

Examples

gname <- "pvmtest"
## Not run: myinum <- .PVM.joingroup (gname)
## Not run: .PVM.lvgroup (gname)

[Package rpvm version 0.6-2 Index]