---
name: "pvm_pstat"
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_pstat"
---

# pvm\_pstat(3)

Returns the status of the specified PVM process.

## NAME

pvm\_pstat - Returns the status of the specified PVM process.

## SYNOPSIS

```
C	int status = pvm_pstat( tid )
Fortran	call pvmfpstat( tid, status )
```

## PARAMETERS

- tid

  **Integer task identifier of the PVM process in question.**\

- status

  **Integer returns the status of the PVM process identified by** *tid.* **Status is PvmOk if the task is running, PvmNoTask if not, and** **PvmBadParam if the** *tid* **is bad.**

## DESCRIPTION

**The routine** *pvm\_pstat* **returns the status of the process identified by** *tid.* **Also note that pvm\_notify() can be used to notify the caller that a task** **has failed.**

## EXAMPLES

```
C:
	tid = pvm_parent();
	status = pvm_pstat( tid );

Fortran:
	CALL PVMFPARENT( TID )
	CALL PVMFPSTAT( TID, STATUS )
```

## ERRORS

**The following error conditions can be returned by** *pvm\_pstat.*

- PvmBadParam

  **Bad Parameter, most likely an invalid tid value.**

- PvmSysErr

  **pvmd not responding.**

- PvmNoTask

  **Task not running.**

## SEE ALSO

**pvm\_notify(3PVM)**