pbs_orderjob(3B)

✨ NAME ✨

okay bestie, welcome to pbs_orderjob(3B) — the little routine that swaps positions of two PBS batch jobs like it’s rearranging seats in the group chat. 💅

🎀 SYNOPSIS 🎀

#include <pbs_error.h>
#include <pbs_ifl.h>

int pbs_orderjob(int connect, char *job_id1, char *job_id2,
                 char *extend)

💅 DESCRIPTION 💅

So this one issues a batch request to swap the positions of two jobs. Iconic behavior, fr fr.

It generates an Order Job (50) batch request and sends it to the server over the connection specified by connect. No cap, that’s the whole move.

It can be used on jobs and job arrays. It can also be used on jobs in different queues. But bestie, listen: both jobs must be at the same server. Both. Same server. That’s the vibe check. 🫶

🚨 Real talk: You cannot swap positions of jobs that are running. Like, absolutely not. That’s the rule.

🧚 ARGUMENTS 🧚

• connect — Return value of pbs_connect(). Specifies the connection over which to send the batch request to the server. It’s giving “this is the line we’re calling on.” ☎️
• jobID1, jobID2 — IDs of jobs to be swapped. Format for a job: <sequence number>.<server name>. Format for a job array: <sequence number>[].<server name>. Slay those exact formats, bestie. 🎀
• extend — Character string for extensions to the command. Not currently used. It’s literally just chilling there for now. 💀

🌈 RETURN VALUE 🌈

The routine returns 0 (zero) on success. Yay, success, we love that for us. ✨

If an error occurred, the routine returns a non-zero exit value, and the error number is available in the global integer pbs_errno. So yeah, check pbs_errno if things get messy. 😭

🔥 SEE ALSO 🔥

• qmove(1B)
• qorder(1B)
• qsub(1B)
• pbs_connect(3B)

okay that’s the whole page, bestie 🫶 signing off from Local — PBS Professional, 15 November 2019, pbs_orderjob(3B). 💖