---
name: "pvmfmytid"
section: "3"
platform: "linux"
package: "pvm-dev"
version: "3.4.2-8"
release: "Debian 3.0 (Woody)"
platforms: ["linux"]
url: "https://new.carta.tech/pvm_mytid"
---

# pvmfmytid(3)

Returns the tid of the calling process.

Part of [pvm\_mytid(3)](/pvm_mytid/3.md).

## 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)**