GETTID(3PVM)

💖 GETTID — pvm_gettid 💖

okay so bestie, welcome to the PVM Version 3.4 corner of the manual, where we're talking about pvm_gettid from 3PVM. This little icon is your ✨group-name-to-task-id✨ translator and honestly? she ate. 💅

---

🌸 NAME 🌸

pvm_gettid</p> — returns the tid of the process identified by a group name and instance number. 🎀

Like, you know their name and their little number, and she hands you the tid. Matchmaker energy, fr fr.

---

✨ SYNOPSIS ✨

C bestie:

int tid = pvm_gettid( char *group, int inum )

Fortran bestie:

call pvmfgettid( group, inum, tid )

---

🦋 PARAMETERS 🦋

• group — a character string holding the name of an existing group. existing, okay? we'll get to that. 👀
• inum — the integer instance number of the process in the group. 🔢
• tid — the integer task identifier that gets returned. the whole point, the main character, the moment 👑

---

💜 DESCRIPTION 💜

So 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. slay, we love a positive tid 🫶

If some error occurs then tid will be < 0. not slay, but at least she told you 💀

That's it. That's the whole vibe. Name + number in, tid out. ✨

---

🌈 EXAMPLES 🌈

C:

tid = pvm_gettid("worker",0);

Fortran:

CALL PVMFGETTID('worker',5,TID)

See how the Fortran one's asking for instance 5 while the C one wants instance 0? Both valid, both cute, just different numbers bestie. 🍓

---

😭 ERRORS 😭

These error conditions can be returned by pvm_gettid. read these, they're literally the answer to "why is my tid negative":

• PvmSysErr — can not contact the local pvmd; most likely it is not running. she's not even home. go check on her. 🙈
• PvmBadParam — bad parameter, most likely a NULL character string. bestie you passed her nothing. nothing!! 😭
• PvmNoGroup — no group exists by that name. the group is giving imaginary 💀
• PvmNoInst — no such instance in the group. the group exists, that number doesn't. close but no. 🧚

---

👑 SEE ALSO 👑

• pvm_joingroup(3PVM)
• pvm_getinst(3PVM)

---

And that's the page!! 💖 This one's from PVM Version 3.4, dated 30 August, 1993 — yeah she's vintage, she's a classic, she's been serving tids since before we were born and she still looks good doing it. periodt. 🌈✨💅