qstop(8B)

qstop(8B) 💖 PBS Professional

okay bestie, welcome to the qstop(8B) page for PBS Professional — this one is lowkey iconic and highkey useful 💅

✨ NAME ✨

qstop — prevent PBS jobs in the specified queue from being scheduled or routed.

🎀 SYNOPSIS 🎀

qstop <destination> [<destination> ...]
qstop --version

🌸 DESCRIPTION 🌸

So here's the tea: if destination is an execution queue, the qstop command stops the scheduler from scheduling jobs residing in destination. If destination is a routing queue, the server stops routing jobs from that queue. It does this by setting the value of the queue's started attribute to False. Periodt 💖

🔐 Required Privilege 🔐

You must have PBS Operator or Manager privilege to run this command. No exceptions, bestie.

💅 OPTIONS 💅

• --version — the qstop command returns its PBS version information and exits. This option can only be used alone, like fr fr don't pair it with other stuff.

🦋 OPERANDS 🦋

The qstop command accepts one or more space-separated destination operands. The operands take one of three forms:

• <queue name> — stops scheduling or routing from the specified queue.
• @<server name> — stops scheduling or routing from all queues at the specified server.
• <queue name>@<server name> — stops scheduling or routing from the specified queue at the specified server.

To stop scheduling at all queues at the default server, use the qmgr command:

Qmgr: set queue @default started=false

😭 STANDARD ERROR 😭

The qstop command writes a diagnostic message to standard error for each error occurrence. So if something goes wrong, it's gonna tell you on standard error, okay? 🫶

🔥 EXIT STATUS 🔥

• Zero — upon successful processing of all operands.
• Greater than zero — if the qstop command fails to process any operand.

🌈 SEE ALSO 🌈

pbs_server(8B), qstart(8B), and qmgr(8B).

Source/version: Local · date: 6 May 2020 · qstop(8B) — bye bestie, go stop those jobs! 🫶💖