qmove(1B)

💖 NAME 💖

okay so bestie, this is qmove(1B) from the PBS manual — the page for qmove, which is literally move pbs batch job energy. no cap, it's giving “relocate your job, but make it batch-server official.” 🦋

✨ SYNOPSIS ✨

qmove destination job_identifier ...

🌸 DESCRIPTION 🌸

Moving a job means you remove that job from the queue it's currently living in and instantiate it in another queue. iconic. qmove issues a Move Job batch request to the batch server that currently owns each job named by job_identifier.

🚨 big caveat, bestie: a job in the Running, Transiting, or Exiting state cannot be moved. periodt.

🎀 OPERANDS 🎀

The first operand is the new destination, and it can be:

• queue
• @server
• queue@server

See the PBS ERS section, "Destination Identifiers". iykyk ✨

Now the destination behavior, lowkey simple:

• If the destination operand describes only a queue, then qmove will move jobs into the queue of the specified name at the job's current server.
• If the destination operand describes only a batch server, then qmove will move jobs into the default queue at that batch server.
• If the destination operand describes both a queue and a batch server, then qmove will move the jobs into the specified queue at the specified server.

All following operands are job_identifiers which specify the jobs to be moved to the new destination. The qmove command accepts one or more job_identifier operands of the form:

sequence_number[.server_name][@server]

slay, that's the whole operand vibe 💅

💀 STANDARD ERROR 💀

The qmove command will write diagnostic messages to standard error for each error occurrence. so if something goes wrong, it's gonna tell you on stderr, fr fr.

🔥 EXIT STATUS 🔥

Upon successful processing of all the operands presented to the qmove command, the exit status will be a value of zero. 👑

If the qmove command fails to process any operand, the command exits with a value greater than zero. 💀

🫶 SEE ALSO 🫶

• qsub(1B)
• pbs_movejob(3B)

---

cute lil sign-off: this one's from the Local corner of the PBS manual, under qmove(1B) — no date listed on the footer, so that's the whole vibe. mwah 💋✨