pbs_submit_resv(3B)

✨ pbs_submit_resv(3B) — PBS Professional ✨

okay so bestie, you wanna submit a PBS reservation from a C program? this is the function for you 💅 it's a <something>(3B) manpage from PBS Professional, and honestly it's a whole vibe.

🌸 NAME 🌸

pbs_submit_resv — submit a PBS reservation 🎀

🦋 SYNOPSIS 🦋

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

char *pbs_submit_resv(int connect, struct attropl *attrib_list,
                      char *extend)

💖 DESCRIPTION 💖

So what it does is it issues a batch request to submit a brand-new reservation ✨ like, it generates a Submit Reservation (70) batch request and sends it off to the server over the connection you passed in as connect.

Then it returns a pointer to the reservation ID. that's it, that's the whole function, and it ate 💅

🌈 ARGUMENTS 🌈

• connect — the return value of pbs_connect(), fr fr. it specifies the connection over which the batch request gets sent to the server 🔥
• attrib_list — pointer to a list of attributes to set, with values 🫶. each attribute is described in an attropl structure, defined in pbs_ifl.h as:

struct attropl {
        struct attropl *next;
        char           *name;
        char           *resource;
        char           *value;
        enum batch_op  op;
};

for any attribute that's not specified, or that's a null pointer, PBS takes the default action for that attribute 👑. the default action is either to assign the default value or to not pass the attribute with the reservation — which one it is depends on the attribute. so like, it's giving "trust the process" but the process is per-attribute 🙈

• extend — character string for extensions to the command. not currently used. so yeah, it's just kinda there, living its best life ✨

🧚 Members of attropl Structure 🧚

• next — points to the next attribute in the list. a null pointer terminates the list. so the null is the end-of-list signal, iconic ⭐
• name — points to a string containing the name of the attribute 🎀
• resource — points to a string containing the name of a resource. used only when the specified attribute contains resource information 🦋. otherwise, resource should be a null pointer, no cap.
• value — points to a string containing the value of the attribute or resource 💜
• op — the operator. the only allowed operator for this function is SET. periodt 👑

🔥 RETURN VALUE 🔥

Returns a pointer to a character string containing the reservation ID assigned by the server 👑

If an error occurred, the routine returns a null pointer, and the error number is available in the global integer pbs_errno 😭 so like, check that.

🧼 CLEANUP 🧼

The space for the reservation ID returned by pbs_submit_resv() is allocated by pbs_submit_resv() itself — so please, bestie, free it via a call to free() when you no longer need it 💀 don't be out here leaking memory, that's not the main character energy we're going for.

⭐ SEE ALSO ⭐

• pbs_rsub(1B)
• pbs_connect(3B)

and that's the page, bestie!! 🍓 this local page was dated 15 November 2019 and it's pbs_submit_resv(3B) all the way through, from the good people at PBS Professional — go forth and reserve responsibly 🫶💖✨