pbs_terminate(3B)

✨ NAME ✨

okay bestie, welcome to pbs_terminate(3B) — the manual page for pbs_terminate, and its whole personality is literally terminate a pbs batch server 💅

🌸 SYNOPSIS 🌸

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

int pbs_terminate(int connect, int manner, char *extend)

🦋 DESCRIPTION 🦋

So here's the vibe: you issue a batch request to shut down a batch server, and this request requires the privilege level usually reserved for batch operators and administrators. 👑

A Server Shutdown batch request is generated and sent to the server over the connection specified by connect, which is the return value of pbs_connect(). that's the connection handshake, no cap 🫶

The parameter manner specifies the manner in which the server is shut down. The available manners are defined in pbs_ifl.h as:

• #define SHUT_IMMEDIATE 0 — shutdown is to be immediate; running jobs are checkpointed, requeued, or deleted as required. 🔥
• #define SHUT_DELAY 1 — jobs which can be checkpointed are checkpointed, terminated, and requeued. Jobs which cannot be checkpointed but are rerunnable are terminated and requeued. Shutdown is delayed until the remaining running jobs complete. No new jobs will be started by the server. 🫶

The server will not respond to the batch request until the server has completed its termination procedure. literally waiting for the whole glow-down to finish ✨

The parameter extend is reserved for implementation defined extensions. (so don't be inventing your own lore for it, bestie 🙈)

This call requires PBS Operator or Manager privilege. 👑

🌈 SEE ALSO 🌈

• qterm(8B)
• pbs_connect(3B)

💖 DIAGNOSTICS 💖

When the batch request generated by pbs_terminate() 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. 😭

bye bestie 👋 — footer source/version vibes: Local + pbs_terminate(3B); no date line was printed on this one, so that's the whole cute sign-off 💖✨