bionic (3) pvm_gettid.3PVM.gz

NAME

       pvm_gettid - Returns the tid of the process identified by a group name and instance number.

SYNOPSIS

       C    int tid = pvm_gettid( char *group, int inum )

       Fortran   call pvmfgettid( group, inum, tid )

PARAMETERS

       group   Character string that contains the name of an existing group.

       inum    Integer instance number of the process in the group.

       tid     Integer task identifier returned.

DESCRIPTION

       The  routine  pvm_gettid  returns  the  tid of the PVM process identified by the group name group and the
       instance number inum.  If pvm_gettid is successful, tid will be > 0.  If some error occurs then tid  will
       be < 0.

EXAMPLES

       C:
              tid = pvm_gettid("worker",0);

       Fortran:
               CALL PVMFGETTID('worker',5,TID)

ERRORS

       These error conditions can be returned by pvm_gettid.

       PvmSysErr
              Can not contact the local pvmd; most likely it is not running.

       PvmBadParam
              Bad Parameter most likely a NULL character string.

       PvmNoGroup
              No group exists by that name.

       PvmNoInst
              No such instance in the group.

SEE ALSO

       pvm_joingroup(3PVM), pvm_getinst(3PVM)

                                                 30 August, 1993                                    GETTID(3PVM)