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 numbers 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 ALSO

       pvm_lvgroup(3PVM)

								  30 August, 1993						   JOINGROUP(3PVM)