pvm_getinst(3pvm) [debian man page]

GETINST(3PVM)							  PVM Version 3.4						     GETINST(3PVM)

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)

Check Out this Related Man Page

GETTID(3PVM)							  PVM Version 3.4						      GETTID(3PVM)

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)

Linux and UNIX Man Pages

pvm_getinst(3pvm) [debian man page]

Check Out this Related Man Page