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)