---
name: "pvmfgettid"
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_gettid"
---

# pvmfgettid(3)

Returns the tid of the process identified by a group name and instance number.

Part of [pvm\_gettid(3)](/pvm_gettid/3.md).

## NAME

pvm\_gettid - Returns the tid of the process identified by a group name and instance number.

## SYNOPSIS

```
C	int tid = pvm_gettid( char *group, int inum )
Fortran	call pvmfgettid( group, inum, tid )
```

## PARAMETERS

- group

  **Character string that contains the name of an existing group.**\

- inum

  **Integer instance number of the process in the group.**\

- tid

  **Integer task identifier returned.**

## DESCRIPTION

**The routine** *pvm\_gettid* **returns the tid of the PVM process** **identified by the group name** *group* **and the instance number** *inum.* **If pvm\_gettid is successful,** *tid* **will be \> 0.** **If some error occurs then** *tid* **will be \< 0.**

## EXAMPLES

```
C:
	  tid = pvm_gettid("worker",0);

Fortran:
	   CALL PVMFGETTID('worker',5,TID)
```

## ERRORS

**These error conditions can be returned by** *pvm\_gettid.*

- PvmSysErr

  **Can not contact the local pvmd; most likely it is not running.**

- PvmBadParam

  **Bad Parameter most likely a NULL character string.**

- PvmNoGroup

  **No group exists by that name.**

- PvmNoInst

  **No such instance in the group.**

## SEE ALSO

**pvm\_joingroup(3PVM),** **pvm\_getinst(3PVM)**