qmove(1B)

💖 NAME: qmove(1B) 💖

okay bestie, welcome to the qmove(1B) page from PBS Professional — yes, the command is qmove, and its whole thing is move PBS batch job. main character energy, no cap. 💅

✨ SYNOPSIS ✨

qmove <destination> <job ID> [<job ID> ...]
qmove --version

🌸 DESCRIPTION 🌸

okay so qmove moves a job from one queue to another. that's the whole serve. ✨

quick vibe check: the behavior of the qmove command may be affected by any site hooks. site hooks can modify the job's attributes, change its routing, etc. so yeah, they can absolutely change the tea. 🫖

🚧 Restrictions 🚧

• qmove can be used on job arrays, but not on subjobs or ranges of subjobs. periodt. 💀
• Job arrays can only be moved from one server to another if they are in the 'Q', 'H', or 'W' states, and only if there are no running subjobs. The state of the job array is preserved, and the job array will run to completion on the new server. slay, but only under those exact conditions. 👑
• A job in the Running, Transiting, or Exiting state cannot be moved. not happening, bestie. 🙈
• A job in the process of provisioning cannot be moved. nope, not even a little. 🚫

👑 EFFECT OF PRIVILEGE ON BEHAVIOR 👑

here's the privilege tea, and it matters:

An unprivileged user can use the qmove command to move a job only when the move would not violate queue restrictions.

A privileged user (root, Manager, Operator) can use the qmove command to move a job under some circumstances where an unprivileged user cannot.

The following restrictions apply only to unprivileged users:

• The queue must be enabled
• Moving the job into the queue must not exceed the queue limits for jobs or resources
• If the job is an array job, the size of the job array must not exceed max_array_size for the queue
• The queue cannot have its from_route_only attribute set to True (accepting jobs only from routing queues)

💅 OPTIONS 💅

• --version — the qmove command returns its PBS version information and exits. This option can only be used alone. like, do not pair it with anything, okay? it's solo main character energy. 🌟

🎀 OPERANDS 🎀

📍 destination

Where job(s) are to end up. It's the first operand, periodt. Syntax:

• <queue name> — Moves the job(s) into the specified queue at the job's current server.
• @<server name> — Moves the job(s) into the default queue at the specified server.
• <queue name>@<server name> — Moves the job(s) into the specified queue at the specified server.

🎯 job ID

Job(s) and/or job array(s) to be moved to the new destination. The qmove command accepts one or more job ID operands of the form:

<sequence number>[.<server name>][@<server name>]
<sequence number>[][.<server name>][@<server name>]

Note that some shells require that you enclose a job array identifier in double quotes. iykyk. 🐚

😭 STANDARD ERROR 😭

The qmove command writes diagnostic messages to standard error for each error occurrence. so if something goes wrong, it will absolutely tell you. 🫶

⭐ EXIT STATUS ⭐

• Zero — upon success
• Greater than zero — upon failure

🫶 SEE ALSO 🫶

qsub(1B), pbs_movejob(3B)

kisses 💋 — this qmove(1B) page says Local, dated 6 May 2020. 💖