JOINGROUP(3PVM) PVM Version 3.4 JOINGROUP(3PVM)NAME
pvm_joingroup - Enrolls the calling process in a named group.
SYNOPSIS
C int inum = pvm_joingroup( char *group )
Fortran call pvmfjoingroup( group, inum )
PARAMETERS
group Character string group name of an existing group.
inum Integer instance number returned by the routine. Instance num‐
bers start at 0 and count up. Values less than zero indicate
an error.
DESCRIPTION
The routine pvm_joingroup enrolls the calling task in the group named
group and returns the instance number inum of this task in this group.
If there is an error inum will be negative.
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 guaran‐
teed 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.
EXAMPLES
C:
inum = pvm_joingroup( "worker" );
Fortran:
CALL PVMFJOINGROUP( 'group2', INUM )
ERRORS
These error conditions can be returned by pvm_joingroup
PvmSysErr
pvmd was not started or has crashed.
PvmBadParam
giving a NULL group name.
PvmDupGroup
trying to join a group you are already in.
SEE ALSOpvm_lvgroup(3PVM)
30 August, 1993 JOINGROUP(3PVM)