CONDOR_QEDIT(1)

📦
version 25.14.1 · 12 versions
, in fedora 43

✨ NAME ✨

okay so bestie, meet condor_qedit 💅 — she lives in the HTCondor Manual (section 1, as in condor_qedit(1), iykyk) and her whole job is: modify job attributes.

Like. She edits the ClassAd attributes of jobs that are sitting in the queue. That's the vibe. 🎀

🌸 SYNOPSIS 🌸

condor_qedit [-debug ] [-n schedd-name] [-pool pool-name] [-forward ]
{cluster | cluster.proc | owner | -constraint constraint} edit-list

💖 DESCRIPTION 💖

okay so condor_qedit modifies job ClassAd attributes of queued HTCondor jobs. That's literally her whole thing. 👑

The jobs you're editing get picked either by cluster number, by job ID, by owner, or by a ClassAd constraint expression.

Now the edit-list — she's flexible, she can take one of 3 forms:

  • attribute-name attribute-value ... This is the older form, which behaves the same as the format below. (she's retro, she still works 🫶)
  • attribute-name=attribute-value ... The attribute-value may be any ClassAd expression. String expressions must be surrounded by double quotes. Multiple attribute value pairs may be listed on the same command line. slay, batch editing.
  • -edits[:auto|long|xml|json|new] file-name The file indicated by file-name is read as a classad of the given format. If no format is specified or auto is specified the format will be detected. if file-name is - standard input will be read. ✨
🚨 security check bestie 🚨 To ensure security and correctness, condor_qedit will not allow modification of the following ClassAd attributes:
  • Owner
  • ClusterId
  • ProcId
  • MyType
  • TargetType
  • JobStatus

Those are the protected girlies. Do not touch. 🙈

Since JobStatus may not be changed with condor_qedit, use condor_hold to place a job in the hold state, and use condor_release to release a held job, instead of attempting to modify JobStatus directly. periodt.

okay and this part is important, no cap: if a job is currently running, modified attributes for that job will not affect the job until it restarts. As an example, for PeriodicRemove to affect when a currently running job will be removed from the queue, that job must first be evicted from a machine and returned to the queue. The same is true for other periodic expressions, such as PeriodicHold and PeriodicRelease. like she's not gonna reach into a running job and yank stuff around, be serious 😭

condor_qedit validates both attribute names and attribute values, checking for correct ClassAd syntax. An error message is printed, and no attribute is set or changed if any name or value is invalid. all-or-nothing queen behavior. 👑

🎀 OPTIONS 🎀

  • -help — Display usage information and exit. 🦋
  • -debug — Causes debugging information to be sent to stderr, based on the value of the configuration variable TOOL_DEBUG.
  • -dry-run — Do not modify any job attributes; instead, report whether the requested edit would be permitted. Useful for checking which attributes are protected or otherwise not editable before performing the actual update. Requires a condor_schedd that supports the -dry-run query. (a lil peek before the commit, we love to see it 💜)
  • -n schedd-name — Modify job attributes in the queue of the specified schedd.
  • -pool pool-name — Modify job attributes in the queue of the schedd specified in the specified pool.
  • -forward — Forward modifications to shadow/gridmanager.
  • -constraint expression — Restrict the edit to jobs for which the ClassAd expression evaluates to true. May be combined with -owner and -jobids; only jobs that match all of the supplied restrictions will be edited. If only -constraint is given, jobs not owned by the current user are skipped unless the user is a queue superuser.
  • -owner owner — Restrict the edit to jobs owned by owner. May be combined with -jobids and -constraint.
  • -jobids id-list — Restrict the edit to the comma-separated list of job IDs in id-list. Each ID may be a cluster or a cluster.proc. May be combined with -owner and -constraint.
  • -edits[:auto|long|xml|json|new] file — Read the attribute = value edit list from file, in ClassAd format. The optional format qualifier selects the input format; the default auto detects the format from the input. If file is -, edits are read from standard input.

🦋 EXAMPLES 🦋

$ condor_qedit -name north.cs.wisc.edu -pool condor.cs.wisc.edu 249.0 answer 42
Set attribute "answer".
$ condor_qedit -name perdita 1849.0 In '"myinput"'
Set attribute "In".
% condor_qedit jbasney OnExitRemove=FALSE
Set attribute "OnExitRemove".
% condor_qedit -constraint 'JobUniverse == 1' 'Requirements=(Arch == "INTEL") && (OpSys == "SOLARIS26") && (Disk >= ExecutableSize) && (VirtualMemory >= ImageSize)'
Set attribute "Requirements".

look at her go. iconic. 🔥

⭐ GENERAL REMARKS ⭐

A job's ClassAd attributes may be viewed with:

$ condor_q -long

go peek before you edit, bestie. 👀

💀 EXIT STATUS 💀

  • 0 — Success 🎉
  • 1 — Failure 😭

👑 SEE ALSO 👑

condor_q, condor_submit, condor_prio, condor_hold, condor_release

the whole friend group fr fr. 🫶

🌈 AVAILABILITY 🌈

Linux, MacOS, Windows — she's everywhere, she's universal. 💅

💜 AUTHOR 💜

HTCondor Team

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 bye bestie, go forth and edit responsibly 💖✨ this was the HTCondor Manual, condor_qedit, dated Oct 16, 2026 — no cap, that's the whole thing, you ate it. 🎀🦋🧚

📦 where this page comes from