NAME

pvm_getinst − Returns the instance number in a group of a PVM process. 
 

SYNOPSIS

Cint inum = pvm_getinst( char ∗group, int tid )
 
Fortrancall pvmfgetinst( group, tid, inum )

PARAMETERS

groupCharacter string group name of an existing group. 

tidInteger task identifier of a PVM process. 

inumInteger instance number returned by the routine.  Instance numbers start at 0 and count up.  Values less than zero indicate an error. 
 

DESCRIPTION

The routine pvm_getinst takes a group name group and a PVM task identifier tid and returns the unique instance number that corresponds to the input.  It can be called by any task whether in the group or not.  If pvm_getinst is successful, inum will be >= 0.  If some error occurs then inum will be < 0. 
 

EXAMPLES

C:
inum = pvm_getinst( "worker", pvm_mytid() );
--------
inum = pvm_getinst( "worker", tid[i] );
Fortran:
CALL PVMFGETINST( ’GROUP3’, TID, INUM )

ERRORS

These error conditions can be returned by pvm_getinst

PvmSysErr
pvmd was not started or has crashed.

PvmBadParam
giving an invalid tid value.

PvmNoGroup
giving a non-existent group name.

PvmNotInGroup
specifying a group in which the tid is not a member.

SEE ALSO

pvm_joingroup(3PVM), pvm_gettid(3PVM)

  —  30 August, 1993