pbs_delresv(3B)

📦 version 23.06.06-unstable-2026-04, in nixos 26.05, nixpkgs unstable

✨ NAME ✨

Okay bestie, this is pbs_delresv(3B) from PBS Professional — the page all about deleting a reservation. 💅

pbs_delresv — delete a reservation. That’s it, that’s the tweet. ✨

🌸 SYNOPSIS 🌸

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

int pbs_delresv(int connect, char *reservationID, char *extend)

💖 DESCRIPTION 💖

It fires off a batch request to delete a reservation, no cap.

Under the hood, this function builds a Delete Reservation (72) batch request and sends it to the server over the connection you pass in connect. Slay.

🚨 Real talk: if the reservation is in state RESV_RUNNING, and there are jobs in the reservation queue, those jobs are deleted before the reservation is deleted. Like, they’re gone first. Periodt.

🎀 ARGUMENTS 🎀

  • connect — the return value of pbs_connect(). It specifies the connection over which the batch request gets sent to the server. Lowkey it’s the “where am I sending this” vibe. 🫶
  • reservationID — the reservation to be deleted. The formats are exact, bestie:
    • Format for advance reservation: R<sequence number>.<server name>
    • Format for standing reservation: S<sequence number>.<server name>
    • Format for maintenance reservation: M<sequence number>.<server name>
  • extend — a character string for extensions to the command. Not currently used. Yes, it’s giving “why am I here” energy, but it’s in the signature. 💀

🔥 RETURN VALUE 🔥

The routine returns 0 (zero) on success. Iconic.

On error, the routine returns a non-zero exit value, and the error number is available in the global integer pbs_errno. So check that, fr fr.

👑 SEE ALSO 👑

  • pbs_rdel(1B)
  • pbs_connect(3B)

Signed with love from Local, 15 November 2019, on pbs_delresv(3B) 💖🫶✨

📦 where this page comes from