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)