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)