pbs_rerunjob(3B)

🌸 NAME 🌸

okay so bestie, this is the PBS Professional manual page for pbs_rerunjob(3B) — the function whose whole job is to requeue a PBS batch job. That's it, that's the vibe. 💅

✨ SYNOPSIS ✨

like, here's the exact shape of it, no cap:

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

int pbs_rerunjob(int connect, char *jobID, char *extend)

🦋 DESCRIPTION 🦋

So pbs_rerunjob issues a batch request to requeue a batch job, job array, subjob, or range of subjobs. Iconic. ✨

It generates a Rerun Job (14) batch request and sends it to the server over the connection specified by connect. That's the whole main character move.

🚨 real talk: you cannot requeue a job that is marked as not rerunnable — the Rerunable attribute is False. Periodt. No cap.

🎀 ARGUMENTS 🎀

• connect — the return value of pbs_connect(). It specifies the connection handle over which to send the batch request to the server. Basically your lil hotline to the server. 💖
• jobID — ID of the job to be requeued. It can show up in these formats:
  • Format for a job: <sequence number>.<server name>
  • Format for a job array: <sequence number>[].<server name>
  • Format for a subjob: <sequence number>[<index>].<server name>
  • Format for a range of subjobs: <sequence number>[<index start>-<index end>].<server name>
• extend — character string for extensions to the command. Not currently used. So rn it's giving decorative parameter energy. 🎀

💜 RETURN VALUE 💜

The routine returns 0 (zero) on success. Slay. ✅

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 if it's acting up, check pbs_errno — that's where the tea is. 😭

🌈 SEE ALSO 🌈

• qrerun(1B)
• pbs_connect(3B)

okay that's the whole page, bestie 🫶 — source/version: Local, dated 15 November 2019, for pbs_rerunjob(3B). 💖