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)