NAME

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

SYNOPSIS

Cint tid = pvm_gettid( char ∗group, int inum )
 
Fortrancall pvmfgettid( group, inum, tid )

PARAMETERS

groupCharacter string that contains the name of an existing group. 

inumInteger instance number of the process in the group. 

tidInteger 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)

  —  30 August, 1993