pbs_modify_resv(3B)

okay so bestie, welcome to pbs_modify_resv(3B) from the PBS Professional manual set 💖 this page is literally all about changing up a reservation, and yes, it's giving “tiny function, important job” energy.

✨ NAME ✨

pbs_modify_resv — modify a PBS reservation 🛠️💅

✨ SYNOPSIS ✨

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

char *pbs_modify_resv(int connect, char *reservationID,
                      struct attropl *attrib_list, char *extend)

✨ DESCRIPTION ✨

So what does it do? It issues a batch request to modify a reservation. Easy. Iconic. Modify Reservation (91) batch request, generated and sent to the server over the connection you pass in as connect. That's the whole vibe 😌✨

✨ ARGUMENTS ✨

• connect — this is the return value of pbs_connect(). It specifies the connection over which to send the batch request to the server 🔌
• reservationID — the reservation you wanna modify, bestie. The formats are:
  • Advance reservation: R<sequence number>.<server name>
  • Standing reservation: S<sequence number>.<server name>
• attrib_list — pointer to a list of attributes to modify. Each attribute is described in an attropl structure, and that's defined in pbs_ifl.h like this:

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

For any attribute that is not specified, or that is a null pointer, PBS takes the default action for that attribute. That default action is to assign the default value or to not pass the attribute with the reservation — which one it is depends on the attribute. No cap, that's just how it goes 🫶

• extend — character string for extensions to the command. Not currently used. She's there, she's just not doing anything yet 💀

🌸 Members of attropl Structure 🌸

• next — points to the next attribute in the list. A null pointer terminates the list ⛓️
• name — points to a string containing the name of the attribute 🏷️
• resource — points to a string containing the name of a resource. This is used only when the specified attribute contains resource information. Otherwise, resource should be a null pointer.

If the resource is already present in the reservation's Resource_List attribute, the value is altered as specified. Otherwise, the resource is added. Slay, resource management 💅

• 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. That's it. That's the rule 🚨

✨ RETURN VALUE ✨

On success, it returns a character string containing the reservation ID assigned by the server. Yay, she worked 🎀👑

On failure, it returns a null pointer, and the error number is available in the global integer pbs_errno. Keep that in your back pocket, bestie 😭

✨ CLEANUP ✨

The space for the reservation ID string is allocated by pbs_modify_resv(). So when you're done with it, release the reservation ID via a call to free() — don't just leave it hanging, that's not the move 🧹🫶

✨ SEE ALSO ✨

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

xoxo 💋 — this page is from the PBS Professional docs, source tag Local, dated 15 November 2019. periodt ✨