pbs_rescreserve(3B)

💖 pbs_rescreserve(3B) — reserve/free batch resources 💖

okay so bestie, welcome to the pbs_rescreserve(3B) page — section 3B, library girlie hours, and it's giving “reserve/free batch resources.” We're covering pbs_rescreserve and pbs_rescrelease, and honestly this page ate. ✨

✨ NAME ✨

• pbs_rescreserve, pbs_rescrelease — reserve/free batch resources. periodt. 💅

📚 SYNOPSIS 📚

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

int pbs_rescreserve(int connect, char **resourcelist, int arraysize,
resource_t *resource_id)

int pbs_rescrelease(int connect, resource_t resource_id)

🌸 DESCRIPTION 🌸

pbs_rescreserver

not me keeping the exact spelling pbs_rescreserver from the page — yes bestie, that's how it's written here, so no autocorrect energy. 💅

This call issues a request to the batch server to reserve specified resources. connect is the connection returned by pbs_connect(). resourcelist is an array of one or more strings specifying the resources to be queried. arraysize is the number of strings in resourcelist. resource_id is a pointer to a resource handle — and bestie, that pointer cannot be null. no cap.

If the present value of the resource handle is RESOURCE_T_NULL, this request is for a new reservation, and if it succeeds, a resource handle will be returned in resource_id. slay.

If the value of resource_id as supplied by the caller is not RESOURCE_T_NULL, then this is an existing (partial) reservation. Resources currently reserved for this handle will be released, and the full reservation will be attempted again. If the caller wishes to release the resources allocated to a partial reservation, the caller should pass the resource handle to pbs_rescrelease(). iykyk.

At the present time, the only resources which may be specified are "nodes". It should be specified as nodes=specification, where specification is what a user specifies in the -l option arguement list for nodes; see qsub(1B). (and yes, arguement is exactly what the page says — keeping it, bestie 😭)

pbs_rescrelease

The pbs_rescrelease() call releases or frees resources reserved with the resource handle of resource_id returned from a prior pbs_rescreserve() call. connect is the connection returned by pbs_connect(). it's giving cleanup main character energy 🧚

Both functions require that the issuing user have operator or administrator privilege. 👑 so yeah, that's the vibe check.

👀 SEE ALSO 👀

• qsub(1B)
• pbs_connect(3B)
• pbs_disconnect(3B)
• pbs_rescquery(3B)
• pbs_resources(7B)

🩺 DIAGNOSTICS 🩺

pbs_rescreserve() and pbs_rescrelease() return zero on success. Otherwise, a non zero error is returned. The error number is also set in pbs_errno.

• PBSE_RMPART — this is a special case indicating that some but not all of the requested resources could be reserved; a partial reservation was made. The reservation request should either be rerequested with the returned handle or the partial resources released.
• PBSE_RMBADPARAM — a parameter is incorrect, such as a null for the pointer to the resource_id.
• PBSE_RMNOPARAM — a parameter is missing, such as a null resoruce list. (yes, that spelling is straight from the page — not me, bestie 😭)

---

okay that's the whole page, bestie 💖 cute sign-off time: source/version is Local, the page is pbs_rescreserve(3B), and the footer didn't give me a date, so I'm not making one up — dateless but iconic. ✨🫶