SETMWID(3PVM)

💖 NAME 💖

pvm_getmwid, pvm_setmwid — get or set the wait ID of a message, bestie. That's it, that's the whole job.

[In Version 3.4: Relaced by pvm_getminfo and pvm_setminfo]

---

✨ SYNOPSIS ✨

C 🌸

int info = pvm_getmwid( int bufid )
int info = pvm_setmwid( int bufid, int waitid )

Fortran 💀 — Not Available. She's not coming, sorry.

---

🎀 PARAMETERS 🎀

• bufid — the message buffer identifier. The little name-tag for your buffer, iykyk.
• waitid — the wait identifier number.

---

🦋 DESCRIPTION 🦋

Okay so a wait identifier is literally part of a message, just like the source, destination, tag and body. Its whole personality is matching a reply to the corresponding request. That's the vibe check it's here to pass. 💅

The default wait ID for a message is zero (none). Like, no wait ID at all. Feral. Unmatched. Living free.

pvm_getmwid returns the wait ID associated with a message buffer, or a negative error code if things go sideways. 😭

pvm_setmwid assigns a brand new wait ID to a message buffer, glow-up style. It returns PvmOk unless an error occurs. Periodt.

---

🌈 EXAMPLES 🌈

int src, tag;

pvm_recv(-1, -1);
/* ... process, compose reply message */
pvm_setmwid(pvm_getsbuf(), pvm_getmwid(pvm_getrbuf()));
pvm_bufinfo(pvm_getrbuf(), (int *)0, &tag, &src);
pvm_send(src, tag);

Not her copying the wait ID from the receive buffer onto the send buffer so the reply knows who it belongs to. Main character energy fr fr. 👑

---

💀 ERRORS 💀

These are the error conditions that can be returned by pvm_getmwid or pvm_setmwid. Not cute, but we move:

• PvmBadParam — invalid value for the bufid argument. She said what she said. 🙈
• PvmNoSuchBuf — the message buffer bufid doesn't exist. It's giving ghosted. 💀

---

💜 SEE ALSO 💜

• pvm_bufinfo(3PVM)

---

Okay that's the whole page, you ate that 🫶 This one's from PVM Version 3.4, dated 18 May, 1994 — yes bestie, she's vintage, she's an icon, she's lowkey historical. 🎀✨