1JOINGROUP(3PVM)                 PVM Version 3.4                JOINGROUP(3PVM)
2
3
4

NAME

6       pvm_joingroup - Enrolls the calling process in a named group.
7
8

SYNOPSIS

10       C    int inum = pvm_joingroup( char *group )
11
12       Fortran   call pvmfjoingroup( group, inum )
13
14

PARAMETERS

16       group   Character string group name of an existing group.
17
18       inum    Integer instance number returned by the routine.  Instance num‐
19               bers start at 0 and count up.  Values less than  zero  indicate
20               an error.
21
22

DESCRIPTION

24       The  routine  pvm_joingroup enrolls the calling task in the group named
25       group and returns the instance number inum of this task in this  group.
26       If there is an error inum will be negative.
27
28       Instance  numbers start at 0 and count up.  When using groups a (group,
29       inum) pair uniquely identifies a PVM process.  This is consistent  with
30       the  PVM  2.4  naming  schemes.   If  a  task leaves a group by calling
31       pvm_lvgroup and later rejoins the same group, the task is  not  guaran‐
32       teed  to  get  the  same  instance  number.   PVM attempts to reuse old
33       instance numbers, so when a task joins a group it will get  the  lowest
34       available  instance  number.  A task can be a member of multiple groups
35       simultaneously.
36
37

EXAMPLES

39       C:
40            inum = pvm_joingroup( "worker" );
41
42       Fortran:
43            CALL PVMFJOINGROUP( 'group2', INUM )
44
45

ERRORS

47       These error conditions can be returned by pvm_joingroup
48
49       PvmSysErr
50              pvmd was not started or has crashed.
51
52       PvmBadParam
53              giving a NULL group name.
54
55       PvmDupGroup
56              trying to join a group you are already in.
57

SEE ALSO

59       pvm_lvgroup(3PVM)
60
61
62
63                                30 August, 1993                JOINGROUP(3PVM)