GETINST(3PVM)

💖 GETINST(3PVM) 💖

okay bestie, welcome to the pvm_getinst page — this one's from PVM Version 3.4 and it's genuinely so useful, i promise. it's a whole 3PVM manual page and we're gonna get through it together, no cap 🫶

---

✨ NAME ✨

pvm_getinst — returns the instance number in a group of a PVM process. that's it, that's the whole job 💅

---

🌸 SYNOPSIS 🌸

C    int inum = pvm_getinst( char *group, int tid )

Fortran   call pvmfgetinst( group, tid, inum )

two languages, one vibe. pick your fighter ✨

---

🎀 PARAMETERS 🎀

• group — character string group name of an existing group. it has to exist, okay? we'll get to that in a sec.
• tid — integer task identifier of a PVM process. the little ID badge your task wears 🪪
• inum — integer instance number returned by the routine. instance numbers start at 0 and count up. values less than zero indicate an error. so if you get a negative bestie, something went wrong, periodt.

---

🦋 DESCRIPTION 🦋

so here's the tea 🍓: pvm_getinst takes a group name group and a PVM task identifier tid, and it returns the unique instance number that corresponds to the input. that's the whole glow-up.

the iconic part? it can be called by any task whether in the group or not. main character energy, honestly — you don't have to be part of the group to ask about it.

if pvm_getinst is successful, inum will be >= 0. if some error occurs, then inum will be < 0. simple as that, no complicated lore 💖

---

🌈 EXAMPLES 🌈

C:

inum = pvm_getinst( "worker", pvm_mytid() );
--------
inum = pvm_getinst( "worker", tid[i] );

Fortran:

CALL PVMFGETINST( 'GROUP3', TID, INUM )

copy these exactly bestie, don't freestyle the arguments 🙈

---

💀 ERRORS 💀

these error conditions can be returned by pvm_getinst — read them, memorize them, love them:

• PvmSysErr — pvmd was not started or has crashed. bestie the daemon is GONE 😭
• PvmBadParam — giving an invalid tid value.
• PvmNoGroup — giving a non-existent group name. you can't get an instance number in a group that isn't real, sorry 💅
• PvmNotInGroup — specifying a group in which the tid is not a member.

---

👑 SEE ALSO 👑

• pvm_joingroup(3PVM)
• pvm_gettid(3PVM)

the little family of group-related calls, go read them too, iykyk ✨

---

and that's the whole page, bestie!! this one came from PVM Version 3.4, dated 30 August, 1993 — yes it's vintage, yes it still slays, and it was literally written before most of us were born 💖 go get those instance numbers, you got this 🫶✨🎀