CONDOR_HOLD(1)

📦
version 25.14.1 · 12 versions
, in fedora 43

💖 condor_hold — the HTCondor manual, bestie edition 💖

okay so this is condor_hold(1), part of the HTCondor Manual, and it's literally the tool that puts your jobs on pause-pause. Not gonna lie, it's iconic. ✨

🌸 NAME 🌸

condor_hold — Prevents existing job(s) from running in HTCondor.

Like. That's it. That's the whole job. It holds them. 💅

🦋 SYNOPSIS 🦋

condor_hold [-help | -version]

condor_hold [OPTIONS] [cluster... | cluster.proc... | user...]

condor_hold [-debug] [-long] [-totals] [-all] [-constraint expression]
[-reason message] [-subcode number] [-pool hostname[:portnumber] | -name
scheddname | -addr "<a.b.c.d:port>"]

✨ DESCRIPTION ✨

So what this does is place job(s) into the hold state in HTCondor. Held jobs stay chillin' in the condor_schedd but they will not be matched to resources or executed. They're just... vibing. Not running. 🫶

And lowkey important: for any given job, only the owner of the job or one of the queue super users (defined by the QUEUE_SUPER_USERS macro) can hold the job. So like, know your permissions, bestie. 👑

🎀 OPTIONS 🎀

  • -help — Display usage information. (Your lil "how do I do this" moment.)
  • -version — Display version information.
  • -long — Display result ClassAd. Fr fr, it shows you the whole ad.
  • -totals — Display success/failure totals. Receipts. 📊
  • -pool hostname[:portnumber] — Specify a pool by giving the central manager's host name and an optional port number.
  • -name scheddname — Send the command to a machine identified by scheddname.
  • -addr "<a.b.c.d:port>" — Send the command to a machine located at "<a.b.c.d:port>".
  • -debug — Causes debugging information to be sent to stderr, based on the value of the configuration variable TOOL_DEBUG.
  • -reason message — Sets the HoldReason attribute to the provided message in the job(s) ClassAd. This message will appear in the output of the condor_q -hold command. (Give your future self context, bestie, it's giving self-care. 💖)
  • -subcode number — Sets the HoldReasonSubCode attribute to the provided number in the job(s) ClassAd.
  • -constraint expression — Hold all jobs which match the job ClassAd expression constraint.
  • -all — Hold all the jobs in the queue. Not me holding literally everything 😭
  • cluster — Hold all jobs in the specified cluster.
  • cluster.process — Hold the specific job in the cluster.
  • user — Hold all jobs belonging to specified user.

🌈 GENERAL REMARKS 🌈

If the -name option is specified, the named condor_schedd is targeted for processing. Otherwise, the local condor_schedd is targeted. iykyk.

A job in the hold state remains in HTCondor, but the job will not run until released via condor_release or removed via condor_rm. So it's not gone — it's just on hold. Main character energy, honestly.

⚠️ Heads up bestie: jobs put on hold while running will send a hard kill signal to stop the current execution. That is not a gentle vibe check, that's a 💀. So be sure before you do it.

⭐ EXIT STATUS ⭐

  • 0 — Success 🎉
  • 1 — Failure has occurred 😭

🍓 EXAMPLES 🍓

To hold a specific job:

$ condor_hold 432.1

To hold a specific job with a reason:

$ condor_hold 432.1 -reason "Defer running job until needed"

To hold all jobs that are not currently running:

$ condor_hold -constraint "JobStatus!=2"

To hold all of user Mary's jobs currently not running:

# condor_hold Mary -constraint "JobStatus!=2"

💜 SEE ALSO 💜

Go read these next, they're all in the same friend group:

  • condor_release
  • condor_rm
  • condor_continue
  • condor_suspend
  • condor_vacate_job
  • condor_vacate

🌸 AVAILABILITY 🌸

Linux, MacOS, Windows. Everywhere. She's universal, periodt. 👑

🧚 AUTHOR 🧚

HTCondor Team. Absolute legends. 🫶

1990-2026, Center for High Throughput Computing, Computer Sciences Department, University of Wisconsin-Madison, Madison, WI, US. Licensed under the Apache License, Version 2.0.

okay that's the whole thing, bestie, you're officially an HTCondor hold girlie now 💖 This was the CONDOR_HOLD(1) page from the HTCondor Manual, dated Oct 16, 2026 — no cap, go hold some jobs (responsibly). ✨🎀🦋

📦 where this page comes from