pbs_alterjob(3B)

✨ NAME ✨

okay so this is pbs_alterjob(3B), from PBS Professional, and it does exactly what it says on the tin: pbs_alterjob — alter a PBS batch job. bestie, it's giving “change your job’s fit without restarting the whole vibe.” 💅

🌸 SYNOPSIS 🌸

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

int pbs_alterjob(int connect, char *jobID, struct attropl *change_list,
                 char *extend)

🦋 DESCRIPTION 🦋

Issues a batch request to alter a batch job. iconic behavior, honestly. 🫶

This command generates a Modify Job (11) batch request and sends it to the server over the connection specified by connect.

⚠️ real talk: job state may affect which attributes can be altered. Peep the qalter(1B) man page for that. no cap.

🎀 ARGUMENTS 🎀

• connect — Return value of pbs_connect(). Specifies connection over which to send batch request to server.
• jobID — ID of job or job array to be altered. Formats, bestie:
  • Format for a job: <sequence number>.<server name>
  • Format for an array job: <sequence number>[].<server name>
• change_list — Pointer to a list of attributes to change. 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;
};

• extend — Character string for extensions to command. Not currently used. lowkey just chilling there. 💀

💅 Members of attropl Structure

• next — Points to next attribute in 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. Used only when the specified attribute contains resource information. Otherwise, resource should be a pointer to a null string.

If the resource is already present in the job's Resource_List attribute, the value is altered as specified. Otherwise the resource is added. slay, it handles both cases. ✨

• value — Points to a string containing the value of the attribute or resource.
• op — Defines the operation to perform on the attribute or resource. For this command, operators are SET, UNSET, INCR, DECR.

⭐ RETURN VALUE ⭐

The routine returns 0 (zero) on success. 🎉

If an error occurred, the routine returns a non-zero exit value, and the error number is available in the global integer pbs_errno. keep an eye on that, bestie. 👀

🌈 SEE ALSO 🌈

• qalter(1B)
• qhold(1B)
• qrls(1B)
• qsub(1B)
• pbs_connect(3B)
• pbs_holdjob(3B)
• pbs_rlsjob(3B)

mwah 💋 this page is from the Local source, dated 15 November 2019, and it's the pbs_alterjob(3B) page for PBS Professional. bye bestie, go alter that job with main character energy! 🫶✨