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

NAME

6       pvm_mytid - Returns the tid of the calling process.
7
8

SYNOPSIS

10       C    int tid = pvm_mytid( void )
11
12       Fortran   call pvmfmytid( tid )
13
14

PARAMETERS

16       tid     Integer  returning  the  task  identifier  of  the  calling PVM
17               process.  Values less than zero indicate an error.
18
19

DESCRIPTION

21       The routine pvm_mytid enrolls this process into PVM on its first  call.
22       It  also  generates  a  unique  tid  if this process was not created by
23       pvm_spawn.  pvm_mytid returns the tid of the calling process and can be
24       called multiple times in an application.
25
26       Any  PVM  system call (not just pvm_mytid) will enroll a task in PVM if
27       the task is not enrolled before the call.
28
29       The tid is a 32 bit positive integer created by the local pvmd.  The 32
30       bits are divided into fields that encode various information about this
31       process such as its location in the virtual machine  (i.e.  local  pvmd
32       address),  the  CPU number in the case where the process is on a multi‐
33       processor, and a process ID field. This information is used by PVM  and
34       is  not  expected  to be used by applications.  Applications should not
35       attempt to predict or interpret the tid with the exception  of  calling
36       tidtohost()
37
38       If  PVM  has not been started before an application calls pvm_mytid the
39       returned tid will be < 0.
40
41

EXAMPLES

43       C:
44            tid = pvm_mytid( );
45
46       Fortran:
47            CALL PVMFMYTID( TID )
48
49

ERRORS

51       This error condition can be returned by pvm_mytid
52
53       PvmSysErr
54              pvmd not responding.
55

SEE ALSO

57       pvm_tidtohost(3PVM), pvm_parent(3PVM)
58
59
60
61                                30 August, 1993                    MYTID(3PVM)