pbs_deljob(3B)

✨ NAME ✨

ok so bestie, this is the pbs_deljob(3B) page, and it's literally all about deleting a PBS batch job. iconic behavior only 💅

🦋 SYNOPSIS 🦋

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

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

💅 DESCRIPTION 💅

So this function issues a batch request to delete a batch job. It generates a Delete Job (6) batch request and sends it to the server over the connection specified by connect. no cap, that's the whole vibe ✨

If the batch job is running, the MoM sends the SIGTERM signal followed by SIGKILL. yes, it's giving "we asked nicely, then we did not" 😭

If the batch job is deleted by a user other than the job owner, PBS sends mail to the job owner. so if you're out here deleting somebody else's job, they WILL find out 📬

🎀 ARGUMENTS 🎀

• connect — this is the return value of pbs_connect(). It specifies the connection over which to send the batch request to the server. basically your little hotline to the server 🫶
• jobID — the ID of the job, job array, subjob, or range of subjobs to be deleted. Here are the formats, exactly:

<sequence number>.<server name>
<sequence number>[].<server name>
<sequence number>[<index>][.<server name>]
<sequence number>[<first>-<last>][.<server name>]

• extend — a character string for extensions to the command. If the string is not null, it is appended to the message mailed to the job owner. tiny note energy, but make it cute 💌

🔥 RETURN VALUE 🔥

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

On error, the routine returns a non-zero exit value, and the error number is available in the global integer pbs_errno. so if something goes sideways, check pbs_errno bestie 👀

🌈 SEE ALSO 🌈

• qdel(1B)
• pbs_connect(3B)

this page is from the Local source/version, dated 15 November 2019, and it's the pbs_deljob(3B) manual page — mwah, go delete responsibly 🎀💖