qstop(8B)

💅 qstop(8B) — the manual page, but make it cute 💅

Okay bestie, so you know how sometimes you just need a queue to chill and stop doing its little job for a sec? That's literally what qstop is for. It's the stop pbs batch job processing at a destination command. Iykyk. 🦋

---

✨ SYNOPSIS ✨

qstop destination ...

---

🌸 DESCRIPTION 🌸

Okay so listen up, because this is the whole vibe: the qstop command directs that a destination should stop processing batch jobs. Slay. 💅

If the destination is an execution queue, the server will cease scheduling jobs that reside in the queue for execution. Basically: no more jobs from that queue are getting the green light. Periodt.

If the destination is a routing queue, the server will cease routing jobs from that queue. It's giving "nope, not today" energy. 🚫

⚠️ Important vibe check: In order to execute qstop, the user must have PBS Operation</> or Manager</> privilege. No privilege, no stop. That's the rule, bestie. Don't come for me. 😭

---

🎀 OPERANDS 🎀

The qstop command accepts one or more destination operands. These operands are legit one of three forms, okay:

• queue
• @server
• queue@server

So let me break it down for you:

• If queue is specified, the request is to stop that queue at the default server. Simple. Iconic. No notes. ✨
• If the @server form is given, the request is to stop all the queues at that server. Like, every single one. Go off, I guess. 👑
• If a full destination identifier, queue@server, is given, the request is to stop the named queue at the named server. The most specific of the vibes. 🎯

---

💀 STANDARD ERROR 💀

The qstop command will write a diagnostic message to standard error for each error occurrence. So if something goes wrong, it's gonna tell you. It's not gonna leave you guessing. Not me being dramatic, just facts. 🫶

---

🦋 EXIT STATUS 🦋

Okay so here's the deal:

Upon successful processing of all the operands presented to the qstop command, the exit status will be a value of zero. We love a clean exit. Successful slay. ✅

But if the qstop command fails to process any operand, the command exits with a value greater than zero. So like, not zero. More than. You get it. 😤

---

🌈 SEE ALSO 🌈

You should also check out these iconic siblings, no cap:

• pbs_server(8B)
• qstart(8B)
• qmgr(1B)

---

And that's the whole page, bestie! 💖 This gem is from the Local manual set for qstop(8B) — the PBS docs from way back. Go forth and stop those queues with confidence. Mwah! 💋🎀🦋