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)

                                         30 August, 1993                            GETINST(3PVM)