.\" $Id: pvm_pstat.3,v 1.1 1996/09/23 22:05:56 pvmsrc Exp $
.TH PSTAT 3PVM "30 August, 1993" "" "PVM Version 3.4"
.SH NAME
pvm_pstat \- Returns the status of the specified PVM process.

.SH SYNOPSIS
.nf
.ft B
C	int status = pvm_pstat( tid )
.br

Fortran	call pvmfpstat( tid, status )
.fi

.SH PARAMETERS
.IP tid 0.8i
Integer task identifier of the PVM process in question.
.br
.IP status
Integer returns the status of the PVM process identified by
.I tid.
Status is PvmOk if the task is running, PvmNoTask if not, and
PvmBadParam if the
.I tid
is bad.

.SH DESCRIPTION
The routine
.I pvm_pstat
returns the status of the process identified by
.I tid.
Also note that pvm_notify() can be used to notify the caller that a task
has failed.

.SH EXAMPLES
.nf
C:
	tid = pvm_parent();
	status = pvm_pstat( tid );
.sp
Fortran:
	CALL PVMFPARENT( TID )
	CALL PVMFPSTAT( TID, STATUS )
.fi

.SH ERRORS
The following error conditions can be returned by
.I pvm_pstat.
.IP PvmBadParam
Bad Parameter, most likely an invalid tid value.
.IP PvmSysErr
pvmd not responding.
.IP PvmNoTask
Task not running.
.PP
.SH SEE ALSO
pvm_notify(3PVM)