GETTID(3PVM)

💖 GETTID 💖

okay bestie, this is a page from PVM Version 3.4, and it's literally all about pvm_gettid — the glow-up that turns a group name + an instance number into an actual task identifier. it's giving "who even IS that process" energy, and we're obsessed 🫶

---

✨ NAME ✨

pvm_gettid — returns the tid of the process identified by a group name and an instance number. no cap, that's the whole job 💅

---

🌸 SYNOPSIS 🌸

so here's how you call her, in both of her languages:

C:

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

Fortran:

call pvmfgettid( group, inum, tid )

---

🎀 PARAMETERS 🎀

• group — a character string holding the name of a group that already exists. she has to be real, bestie, we don't do imaginary groups here 🌈
• inum — an integer, the instance number of the process inside that group 🔢
• tid — an integer task identifier, and this is the one being handed back to you, the return value, the moment ✨

---

🦋 DESCRIPTION 🦋

so pvm_gettid returns the tid of the PVM process that's identified by the group name group and the instance number inum. like, you know the group and you know which instance, and she tells you which actual task that is. iconic.

and here's the vibe check on the result:

• if pvm_gettid is successful, then tid will be > 0 ✅
• if some error occurs, then tid will be < 0 💀

that's it, that's the whole mood. positive number = slay, negative number = something went sideways.

---

🌟 EXAMPLES 🌟

C:

tid = pvm_gettid("worker",0);

Fortran:

CALL PVMFGETTID('worker',5,TID)

look at her go 😭 so simple, so clean, so main character.

---

💀 ERRORS 💀

these are the error conditions that pvm_gettid can throw at you, fr fr:

• PvmSysErr — can't contact the local pvmd. most likely it's just… not running 🙈 she's ghosting you.
• PvmBadParam — bad parameter, most likely a NULL character string. you handed her nothing and she's like, bestie, what am I supposed to do with this.
• PvmNoGroup — no group exists by that name. you're looking for a group that simply does not exist, and that's a whole mood 🌸
• PvmNoInst — no such instance in the group. the group is real but that instance number? not in this house 💅

---

👑 SEE ALSO 👑

go read these too, they're part of the same friend group:

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

---

and that's the whole page, bestie!! this was PVM Version 3.4, dated 30 August, 1993 — yes she's vintage, yes she still ate, periodt 💖✨🎀