qrerun(1B)

🌸 NAME 🌸

okay so bestie, this is the manual page for qrerun(1B) from PBS Professional, and its whole brand is: qrerun - requeue a PBS job. literally the “put it back in the queue” button with main character energy. 💅

✨ SYNOPSIS ✨

qrerun [-W force] <job ID> [<job ID> ...]
qrerun --version

🦋 DESCRIPTION 🦋

If possible, qrerun kills the specified job(s), then requeues each job in the execution queue from which it was run. no cap, that’s the move.

You can use the qrerun command on jobs, job arrays, subjobs, and ranges of subjobs. If you give a job array identifier as an argument, the job array is returned to its initial state at submission time, or to its altered state if it has been qaltered. All of that job array’s subjobs are requeued — which includes those that are currently running, and those that are completed and deleted. If you give a subjob or range as an argument, those subjobs are requeued. 🫶

💅 Restrictions 💅

If a job is marked as not rerunnable, qrerun neither kills nor requeues the job. See the -r option for the qsub and qalter commands, and the Rerunable job attribute.

The qrerun command cannot requeue a job or subjob which is not running, is held, or is suspended. respect the limits, bestie 😭

👑 Required Privilege 👑

PBS Manager or Operator privilege is required to use this command. periodt. 💅

🎀 OPTIONS 🎀

• -W force — the job is to be requeued even if the vnode on which the job is executing is unreachable, or if the job’s substate is provisioning. forceful queen behavior, but only with this flag.
• --version — the qrerun command returns its PBS version information and exits. This option can only be used alone.

🌈 OPERANDS 🌈

The qrerun command accepts one or more job ID operands of the form:

<sequence number>[.<server name>][@<server name>]
<sequence number>[][.<server name>][@<server name>]
<sequence number>[<index>][.<server name>][@<server name>]
<sequence number>[<index start>-<index end>][.<server name>]
                        [@<server name>]

Note that some shells require that you enclose a job array identifier in double quotes. iykyk, wrap it before your shell does something unhinged. 🙈

💀 STANDARD ERROR 💀

The qrerun command writes a diagnostic message to standard error for each error occurrence. it’s giving receipts for every oops. 😭

🔥 EXIT STATUS 🔥

• Zero — upon successful processing of all operands.
• Greater than zero — upon failure to process any operand.

⭐ SEE ALSO ⭐

• qsub(1B)
• qalter(1B)
• pbs_alterjob(3B)
• pbs_rerunjob(3B)

go read these besties, they’re the linked lore 🧚

mwah 💋 — this page is Local, dated 6 May 2020, for PBS Professional. qrerun(1B) out. 🎀✨