getinst(3)
NAME
pvm_getinst - Returns the instance number in a group of a PVM process.
SYNOPSIS
C int inum = pvm_getinst( char *group, int tid ) Fortran call pvmfgetinst( group, tid, inum )
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 num
- bers 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.