pvm_getinst - Returns the instance number in a group of a PVM process.
Contents
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.
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.
Examples
C:
inum = pvm_getinst( "worker", pvm_mytid() );
--------
inum = pvm_getinst( "worker", tid[i] );
Fortran:
CALL PVMFGETINST( 'GROUP3', TID, INUM )
Name
pvm_getinst - Returns the instance number in a group of a PVM process.
Parameters
group Character string group name of an existing group.
tid Integer task identifier of a PVM process.
inum Integer instance number returned by the routine. Instance numbers start at 0 and count up.
Values less than zero indicate an error.
See Also
pvm_joingroup(3PVM), pvm_gettid(3PVM) 30 August, 1993 GETINST(3PVM)
Synopsis
Cintinum=pvm_getinst(char*group,inttid)Fortrancallpvmfgetinst(group,tid,inum)
