MYTID(3PVM) PVM Version 3.4 MYTID(3PVM)NAMEpvm_mytid - Returns the tid of the calling process.
SYNOPSIS
C int tid = pvm_mytid( void )
Fortran call pvmfmytid( tid )
PARAMETERS
tid Integer returning the task identifier of the calling PVM
process. Values less than zero indicate an error.
DESCRIPTION
The routine pvm_mytid enrolls this process into PVM on its first call.
It also generates a unique tid if this process was not created by
pvm_spawn. pvm_mytid returns the tid of the calling process and can be
called multiple times in an application.
Any PVM system call (not just pvm_mytid) will enroll a task in PVM if
the task is not enrolled before the call.
The tid is a 32 bit positive integer created by the local pvmd. The 32
bits are divided into fields that encode various information about this
process such as its location in the virtual machine (i.e. local pvmd
address), the CPU number in the case where the process is on a multiā
processor, and a process ID field. This information is used by PVM and
is not expected to be used by applications. Applications should not
attempt to predict or interpret the tid with the exception of calling
tidtohost()
If PVM has not been started before an application calls pvm_mytid the
returned tid will be < 0.
EXAMPLES
C:
tid = pvm_mytid( );
Fortran:
CALL PVMFMYTID( TID )
ERRORS
This error condition can be returned by pvm_mytid
PvmSysErr
pvmd not responding.
SEE ALSOpvm_tidtohost(3PVM), pvm_parent(3PVM)
30 August, 1993 MYTID(3PVM)