pbs_terminate(3B)

okay so bestie, welcome to pbs_terminate(3B) from PBS Professional — the tiny-but-mighty call that shuts down a PBS batch server. no cap, this one has main character energy, so let's get into it. 💅✨

🌸 NAME 🌸

pbs_terminate — shut down a PBS batch server. literally what it says on the tin, bestie. 🛑

✨ SYNOPSIS ✨

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

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

🦋 DESCRIPTION 🦋

This one issues a batch request to shut down a batch server. it's giving "bye bye server" in the most official way possible. 💖

Specifically, it generates a Server Shutdown (17) batch request and sends it to the server over the connection specified by connect. so fancy, so official. ✨

The pbs_terminate() command exits after the server has completed its shutdown procedure. that part is important, bestie — it does not just dip early, okay? it waits for the shutdown procedure to be done. periodt. 💅

👑 REQUIRED PRIVILEGE 👑

You must have Operator or Manager privilege to run this command. no regular-user shortcuts here, iykyk. 🔥

🎀 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 little server hotline. 💖
• manner — the manner in which to shut down the server. the available manners are defined in pbs_ifl.h. valid values are SHUT_IMMEDIATE, SHUT_DELAY, and SHUT_QUICK. see qterm(8B) for information on the manner in which to shut down the server. pick your shutdown vibe wisely. 🦋
• extend — a character string for extensions to the command. it is not currently used. so yeah, it's that placeholder bestie who showed up to the group chat but isn't saying anything. 🙈

🌈 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 check that if things get messy. 😭

🔥 SEE ALSO 🔥

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

mwah 💋 bestie, this page was brought to you by Local (the source/version cutie), dated 15 November 2019, and it is literally the pbs_terminate(3B) manual page. byeee 🫶🎀