pbs_movejob(3B)

💖 NAME 💖

pbs_movejob — move a pbs batch job to a new destination 🚚✨

okay so this page is from the PBS manual set, and it's literally all about relocating your job. slay.

---

✨ SYNOPSIS ✨

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

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

like, that's the whole signature bestie, no cap 🫶

---

🦋 DESCRIPTION 🦋

so basically you're issuing a batch request to move a job to a new destination 💅. the job gets removed from the present queue and instantiated in a new queue. it's giving "we're moving, pack your bags" energy fr fr.

a Move Job batch request is generated and sent to the server over the connection specified by connect, which is literally the return value of pbs_connect(). iykyk 🌈

here's the cast of characters 🎀:

• job_id — this one identifies which job is getting moved. it's specified in the form: sequence_number.server ⭐
• destination — the new destination for the job. it's specified as: [queue][@server]. and the way this works is honestly so flexible:
  • if destination is a null pointer or a null string, the destination will be the default queue at the current server 💜
  • if destination specifies a queue but not a server, the destination will be the named queue at the current server
  • if destination specifies a server but not a queue, the destination will be the default queue at the named server
  • if destination specifies both a queue and a server, the destination is that queue at that server 🔥

🚨 big mood warning: a job in the Running, Transiting, or Exiting state cannot be moved. like, it's busy, leave it alone 😭💀

• extend — this parameter is reserved for implementation defined extensions. it's not doing anything for you rn, it's just chillin' 🙈

---

🌸 SEE ALSO 🌸

go read these too bestie, they're iconic 👑:

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

---

💀 DIAGNOSTICS 💀

when the batch request generated by the pbs_movejob() function has been completed successfully by a batch server, the routine will return 0 (zero) — periodt, we love a clean win 🎉✨

otherwise, a non zero error is returned. and the error number is also set in pbs_errno so you can go peek at it 👀🍓

---

and that's the whole vibe check, bestie 🧚💖 this page lives in the Local corner of the PBS docs, filed under pbs_movejob(3B) — catch you on the next move 🦋⭐