pbs_movejob(3B)

💅 pbs_movejob — a glam little function from section 3B of the PBS Professional manual

okay bestie, gather round, because today we're talking about pbs_movejob, and honestly? it's giving "relocation service for your batch jobs" and I'm obsessed. ✨

🌸 NAME

pbs_movejob — move a PBS batch job to a new destination 🦋

✨ SYNOPSIS

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

int pbs_movejob(int connect, char *jobID, char *destination,
                char *extend)

like, that's the whole vibe. two includes, one function, four arguments. clean. 💅

🎀 DESCRIPTION

So what does it actually do? It issues a batch request to move a job or a job array to a new destination. main character behavior, honestly.

It generates a Move Job (12) batch request and sends it on over to the server using the connection you specified with connect. slay.

Then it moves the specified job or job array from its current queue and server to the specified queue and server. literally packing its little bags. 🧳

⚠️ important vibe check: you cannot move a job that's in the Running, Transiting, or Exiting states. nope, not happening, don't even try it. 😭

💖 ARGUMENTS

• connect — the return value of pbs_connect(). it tells us which connection to use to send the batch request to the server. think of it as the group chat you're texting in. 🫶
• jobID — the ID of the job you want to move. formats go like this:
  • job: <sequence number>.<server name>
  • job array: <sequence number>[].<server name>
• destination — the new location for your job or job array. so many options, so much freedom, here's the full menu:
  • <queue name>@<server name> — the specified queue at the specified server
  • <queue name> — the specified queue at the default server
  • @<server name> — the default queue at the specified server
  • @default — the default queue at the default server
  • (null pointer or null string) — default queue at default server
• extend — a character string for extensions to the command. not currently used. she's just there for moral support. 🙈

👑 RETURN VALUE

The routine returns 0 (zero) on success. periodt. 🎉

If an error occurred, the routine returns a non-zero exit value, and the error number is available in the global integer pbs_errno. so if something goes wrong, that's where the receipts live. 💀

🌈 SEE ALSO

• qmove(1B)
• pbs_connect(3B)

iykyk — go read those next. 🔥

and that's the page, bestie! this lil number lives in the Local section, dated 15 November 2019, and it's part of the PBS Professional manual. mwah, go move some jobs responsibly 💜🌸