qorder(1B)

💅 qorder(1B) — the manual page, but make it make sense

okay so bestie, this is qorder from PBS Professional, and honestly? it's giving "tiny command, huge main character energy" ✨ it does exactly one (1) thing and it does it slayfully.

🎀 NAME

qorder — swap the queue order of two PBS batch jobs. that's it. that's the whole vibe. periodt.

🌸 SYNOPSIS

qorder <job ID> <job ID>
qorder --version

✨ DESCRIPTION

So what it does: it exchanges the positions in queue(s) of two jobs — and yes, that works whether they're chilling in the same queue or in different queue(s). 🦋

💖 important: no attribute of either job is changed. like, none. not priority, not anything. it's literally just a position swap, no cap.

The actual impact of interchanging the order — within one queue or between queues — depends on your local job scheduling policy. so like... ask your systems administrator, bestie, they know the lore. 🙈

🔒 Restrictions

• a job in the running state cannot be reordered. it's busy. it has a life. 💀
• qorder can be used on job arrays, but not on subjobs or ranges of subjobs.
• the two jobs must be located at the same server.

👑 Effect of Privilege on Behavior

For an unprivileged user to reorder jobs, both jobs must be owned by the user. A privileged user (Manager, Operator) can reorder any jobs — yeah, they have the keys to the group chat. 🔥

🧚 OPTIONS

• --version — The qorder command returns its PBS version information and exits. This option can only be used alone. (like, don't try to pair it with anything, it's a solo act 💅)

🍓 OPERANDS

Both operands are job IDs which specify the jobs to be exchanged. The qorder command accepts two job ID operands of the form:

<sequence number>[.<server name>][@<server name>]
<sequence number>[][.<server name>][@<server name>]

If you specify a server for both jobs, they must be at the same server. no long-distance relationships allowed 😭

⭐ note that some shells require that you enclose a job array identifier in double quotes. your shell is dramatic like that.

💜 STANDARD ERROR

The qorder command writes diagnostic messages to standard error for each error occurrence. so if something goes wrong, it will tell you — loudly, on stderr. 🫶

🌈 EXIT STATUS

• Zero — Upon successful processing of all operands. slay. ✅
• Greater than zero — If the qorder command fails to process any operand. not slay. 💀

🔥 SEE ALSO

qsub(1B), qmove(1B), pbs_orderjob(3B), pbs_movejob(3B)

and that's the whole page, bestie — the Local release, dated 6 May 2020, brought to you by the PBS Professional crew. go forth and reorder responsibly, mwah 💋🎀