NAME

pvm_gettid - Returns the tid of the process identified by a group name and instance number.

SYNOPSIS

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


Fortran	call pvmfgettid( group, inum, tid )

PARAMETERS

group

Character string that contains the name of an existing group.

inum

Integer instance number of the process in the group.

tid

Integer task identifier returned.

DESCRIPTION

The routine pvm_gettid returns the tid of the PVM process identified by the group name group and the instance number inum. If pvm_gettid is successful, tid will be > 0. If some error occurs then tid will be < 0.

EXAMPLES

C:
	  tid = pvm_gettid("worker",0);

Fortran:
	   CALL PVMFGETTID('worker',5,TID)

ERRORS

These error conditions can be returned by pvm_gettid.

PvmSysErr

Can not contact the local pvmd; most likely it is not running.

PvmBadParam

Bad Parameter most likely a NULL character string.

PvmNoGroup

No group exists by that name.

PvmNoInst

No such instance in the group.

SEE ALSO

pvm_joingroup(3PVM), pvm_getinst(3PVM)