pvm_joingroup(3pvm) [redhat man page]

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)

Check Out this Related Man Page

GETINST(3PVM)							  PVM Version 3.4						     GETINST(3PVM)

NAME

       pvm_getinst - Returns the instance number in a group of a PVM process.

SYNOPSIS

       C    int inum = pvm_getinst( char *group, int tid )

       Fortran	 call pvmfgetinst( group, tid, inum )

PARAMETERS

       group   Character string group name of an existing group.

       tid     Integer task identifier of a PVM process.

       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_getinst takes a group name group and a PVM task identifier tid and returns the unique instance number that  corresponds	to
       the  input.   It  can  be  called by any task whether in the group or not.  If pvm_getinst is successful, inum will be >= 0.  If some error
       occurs then inum will be < 0.

EXAMPLES

       C:
	    inum = pvm_getinst( "worker", pvm_mytid() );
	    --------
	    inum = pvm_getinst( "worker", tid[i] );

       Fortran:
	    CALL PVMFGETINST( 'GROUP3', TID, INUM )

ERRORS

       These error conditions can be returned by pvm_getinst

       PvmSysErr
	      pvmd was not started or has crashed.

       PvmBadParam
	      giving an invalid tid value.

       PvmNoGroup
	      giving a non-existent group name.

       PvmNotInGroup
	      specifying a group in which the tid is not a member.

SEE ALSO

       pvm_joingroup(3PVM), pvm_gettid(3PVM)

								  30 August, 1993						     GETINST(3PVM)

Linux and UNIX Man Pages

pvm_joingroup(3pvm) [redhat man page]

Check Out this Related Man Page