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.