1GETINST(3PVM)                   PVM Version 3.4                  GETINST(3PVM)
2
3
4

NAME

6       pvm_getinst - Returns the instance number in a group of a PVM process.
7
8

SYNOPSIS

10       C    int inum = pvm_getinst( char *group, int tid )
11
12       Fortran   call pvmfgetinst( group, tid, inum )
13
14

PARAMETERS

16       group   Character string group name of an existing group.
17
18       tid     Integer task identifier of a PVM process.
19
20       inum    Integer instance number returned by the routine.  Instance num‐
21               bers start at 0 and count up.  Values less than  zero  indicate
22               an error.
23
24

DESCRIPTION

26       The routine pvm_getinst takes a group name group and a PVM task identi‐
27       fier tid and returns the unique instance number that corresponds to the
28       input.   It  can be called by any task whether in the group or not.  If
29       pvm_getinst is successful, inum will be >= 0.   If  some  error  occurs
30       then inum will be < 0.
31
32

EXAMPLES

34       C:
35            inum = pvm_getinst( "worker", pvm_mytid() );
36            --------
37            inum = pvm_getinst( "worker", tid[i] );
38
39       Fortran:
40            CALL PVMFGETINST( 'GROUP3', TID, INUM )
41
42

ERRORS

44       These error conditions can be returned by pvm_getinst
45
46       PvmSysErr
47              pvmd was not started or has crashed.
48
49       PvmBadParam
50              giving an invalid tid value.
51
52       PvmNoGroup
53              giving a non-existent group name.
54
55       PvmNotInGroup
56              specifying a group in which the tid is not a member.
57

SEE ALSO

59       pvm_joingroup(3PVM), pvm_gettid(3PVM)
60
61
62
63                                30 August, 1993                  GETINST(3PVM)
Impressum