Name

pvm_joingroup — enrolls the calling process in a named group.

Calling Sequence

[inum] = pvm_joingroup(group)

Parameters

group

string, string group name of an existing group.

inum

integer, instance number returned by the routine.

Description

pvm_joingroup enrolls the calling task in the group named group and returns the instance number of this task in this group.

The returned value will be >= 0 if the call is successful and will be will be < 0 if some error occurs.

Instance numbers start at 0 and count up. When using groups a (group, inum) pair uniquely identifies a PVM process. This is consistent with the PVM 2.4 naming schemes. 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.

See Also

pvm_lvgroup