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