debian man page for pvm_mytid

MYTID(3PVM)							  PVM Version 3.4						       MYTID(3PVM)

NAME
       pvm_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
       multiprocessor, 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 ALSO
       pvm_tidtohost(3PVM), pvm_parent(3PVM)

								  30 August, 1993						       MYTID(3PVM)