qrls(1B)

💅 qrls — release hold on PBS jobs 🎀

okay bestie, welcome to the qrls(1B) page from PBS Professional — this is the one where we let your jobs out of hold jail ✨

🌸 NAME 🌸

• qrls — release hold on PBS jobs

🦋 SYNOPSIS 🦋

qrls [-h <hold list>] <job ID> [<job ID> ...]
qrls --version

✨ DESCRIPTION ✨

The qrls command removes or releases holds on batch jobs or job arrays — but not on subjobs or ranges of subjobs. no cap, that part matters 💅

A job may have one or more types of holds which make the job ineligible for execution. like, it's literally sitting there waiting for you to free it 🥺

If you qrls a job whose Execution_Time attribute is not set to a time in the future, the job changes to the queued state. If Execution_Time is in the future, the job changes to the waiting state. the way that timing just changes everything 😭

Holds can be set by the owner, an Operator, or Manager, when a job has a dependency, or when a job has its Execution_Time attribute set to a time in the future. see the qhold man page 🫶

👑 Effect of Privilege on Behavior 👑

The following table shows the holds and the privilege required to release each:

• u — User — job owner, Operator, Manager, administrator, root
• o — Other — Operator, Manager, administrator, root
• s — System — Manager, administrator, root, PBS (dependency)
• n — None — job owner, Operator, Manager, administrator, root
• p — Bad password — administrator, root

🎀 OPTIONS 🎀

• (no options) — defaults to -h u, removing user hold. so if you just run it with no flag, it's giving "free my user hold" energy ✨
• -h <hold list> — types of holds to be released for the job(s).

The hold list argument is a string consisting of one or more of the letters "u", "o", or "s" in any combination, or one of the letters "n" or "p". lowkey just pick the letters you need and slay 💅

• --version — the qrls command returns its PBS version information and exits. this option can only be used alone. don't try to pair it with anything else, bestie — it's a solo main character 🙈

🦋 OPERANDS 🦋

The qrls command can be used on jobs and job arrays, but not on subjobs or ranges of subjobs. the qrls command accepts one or more job IDs in the form:

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

not me warning you: some shells require that you enclose a job array identifier in double quotes. don't get caught lacking 🙈

💀 STANDARD ERROR 💀

The qrls command writes a diagnostic message to standard error for each error occurrence. so if something goes wrong, it will tell you — no silent treatment here 💖

🌈 EXIT STATUS 🌈

• Zero — upon successful processing of all operands. we love a clean exit ✨
• Greater than zero — if the qrls command fails to process any operand. not the vibe, but at least you know 😭

💜 SEE ALSO 💜

• qsub(1B)
• qalter(1B)
• qhold(1B)
• pbs_alterjob(3B)
• pbs_holdjob(3B)
• pbs_rlsjob(3B)

that's the whole page, bestie 🫶 this lil icon was brought to you by Local, dated 6 May 2020 — mwah 💋