LVGROUP(3PVM)							  PVM Version 3.4						     LVGROUP(3PVM)

NAME

       pvm_lvgroup - Unenrolls the calling process from a named group.

SYNOPSIS

       C    int info = pvm_lvgroup( char *group )

       Fortran	 call pvmflvgroup( group, info )

PARAMETERS

       group   Character string group name of an existing group.

       info    Integer status code returned by the routine.  Values less than zero indicate an error.

DESCRIPTION

       The routine pvm_lvgroup unenrolls the calling process from the group named group.  If there is an error info will be negative.

       If  a process leaves a group by calling either pvm_lvgroup or pvm_exit, and later rejoins the same group, the process may be assigned a new
       instance number. Old instance numbers are reassigned to processes calling pvm_joingroup.

EXAMPLES

       C:
	    info = pvm_lvgroup( "worker" );

       Fortran:
	    CALL PVMFLVGROUP( 'group2', INFO )

ERRORS

       These error conditions can be returned by pvm_lvgroup

       PvmSysErr
	      pvmd not responding.

       PvmBadParam
	      giving a NULL group name.

       PvmNoGroup
	      giving a non-existent group name.

       PvmNotInGroup
	      asking to leave a group you are not a member of.

SEE ALSO

       pvm_joingroup(3PVM)

								  30 August, 1993						     LVGROUP(3PVM)