PSTAT(3PVM)

💅 PSTAT — the 3PVM girlies' guide to pvm_pstat ✨

okay so bestie, you ever just wanna know if a PVM process is still alive? like, is it thriving or is it ghosting you? that's literally this whole page. no cap. 🫶

---

🌸 NAME 🌸

pvm_pstat — returns the status of the specified PVM process. that's it, that's the job, and she does it flawlessly. 💖

---

🎀 SYNOPSIS 🎀

C:

int status = pvm_pstat( tid )

Fortran:

call pvmfpstat( tid, status )

---

✨ PARAMETERS ✨

• tid — Integer task identifier of the PVM process in question. like, which one are we checking on? that one. 👑
• 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. so basically: living, dead, or you handed her nonsense. 😭

---

🦋 DESCRIPTION 🦋

The routine pvm_pstat returns the status of the process identified by tid. simple. elegant. iconic. ✨

Also note that pvm_notify() can be used to notify the caller that a task has failed. so if you want the gossip pushed to you instead of you going around asking, that's the move. iykyk. 💅

---

🌈 EXAMPLES 🌈

C:

tid = pvm_parent();
status = pvm_pstat( tid );

Fortran:

CALL PVMFPARENT( TID )
CALL PVMFPSTAT( TID, STATUS )

look at her go. main character energy fr fr. 🔥

---

💀 ERRORS 💀

The following error conditions can be returned by pvm_pstat.

• PvmBadParam — Bad Parameter, most likely an invalid tid value. you gave her a fake address bestie, she's not gonna go knocking. 🙈
• PvmSysErr — pvmd not responding. the daemon is not answering her texts. genuinely concerning. 😭
• PvmNoTask — Task not running. she's gone, babe. not sleeping, not resting — just not running. 💀

lowkey important: those last two are NOT the same vibe. one is "the task is over," the other is "the whole pvmd went quiet on us." don't mix them up. 🫶

---

👑 SEE ALSO 👑

pvm_notify(3PVM) — the other girl in this story, and honestly she's the one you call when you want to be told things proactively instead of checking yourself. obsessed. 💜

---

that's the whole page, no notes. this one's from PVM Version 3.4, dated 30 August, 1993, filed under PSTAT(3PVM) — and yeah, she's been serving status updates since the early nineties and she still ate. periodt. 🎀✨💖