GETTID

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.