pbs_deljob(3B)

🌸 NAME — pbs_deljob(3B) 🌸

pbs_deljob — delete a pbs batch job. That’s the whole vibe, bestie: this function asks the batch system to yeet a job out of existence 💅.

✨ SYNOPSIS ✨

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

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

💅 DESCRIPTION 💅

Okay so pbs_deljob() issues a batch request to delete a batch job. If the batch job is running, the execution server will send the SIGTERM signal followed by SIGKILL 💀. That’s the dramatic part — no cap.

⚠️ If the job is running, SIGTERM comes first and SIGKILL follows. That’s the delete pipeline in the original, and it is not subtle.

A Delete Job batch request is generated and sent to the server over the connection specified by connect, which is the return value of pbs_connect() 🫶.

The argument job_id identifies which job is to be deleted, and it is specified in the form:

sequence_number.server

The argument extend is overloaded to serve two purposes, because apparently it contains multitudes ✨:

• If the pointer extend points to a string of the form deldelay=nnnn,, it is used to provide control over the delay between sending the SIGTERM and SIGKILL signals to a running job. The characters nnnn specify a unsigned decimal integer time delay in seconds ⏱️.
• If extend is the null pointer or points to a null string, the administrator established default time delay is used.
• If extend points to a string other than the above, it is taken as text to be appended to the message mailed to to the job owner 😭 (yes, the double “to” is in the original; I’m just the messenger). This mailing occurs if the job is deleted by a user other than the job owner.

🔥 SEE ALSO 🔥

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

💖 DIAGNOSTICS 💖

When the batch request generated by the pbs_deljob() function has been completed successfully by a batch server, the routine will return 0 (zero) 🎉. Otherwise, a non zero error is returned. The error number is also set in pbs_errno.

Final vibe check: this is pbs_deljob(3B) from the Local source/version, under the PBS banner. The footer has no date listed, so I’m not inventing one — just pure icon behavior 🫶💖