table of contents
| CONDOR_PRIO(1) | HTCondor Manual | CONDOR_PRIO(1) |
NAME¶
condor_prio - HTCondor Manual
Change priority of jobs in the HTCondor queue.
SYNOPSIS¶
condor_prio -p priority | +***value* | **-***value* [-n** schedd-name] [-pool pool-name] [-a | cluster | cluster.proc | username]
DESCRIPTION¶
condor_prio changes the priority of one or more jobs in the HTCondor queue. If the job identification is given by cluster.proc, condor_prio attempts to change the priority of the single job with job ClassAd attributes ClusterId <href="../classad-attributes/job-classad-attributes.html#ClusterId"> and ProcId <href="../classad-attributes/job-classad-attributes.html#ProcId">. If described by cluster, condor_prio attempts to change the priority of all processes with the given ClusterId <href="../classad-attributes/job-classad-attributes.html#ClusterId"> job ClassAd attribute. If username is specified, condor_prio attempts to change priority of all jobs belonging to that user. For -a, condor_prio attempts to change priority of all jobs in the queue.
The user must set a new priority with the -p option, or specify a priority adjustment using +value or -value.
The priority of a job can be any integer, with higher numbers corresponding to greater priority. For adjustment of the current priority, +value increases the priority by the amount given with value. -value decreases the priority by the amount given with value.
Only the owner of a job or the super user can change the priority.
The priority changed by condor_prio is only used when comparing to the priority of jobs owned by the same user and submitted from the same machine.
OPTIONS¶
- -p priority
- Set the priority to the specified integer value.
- +value
- Increase the priority by the specified amount.
- -value
- Decrease the priority by the specified amount.
- -a
- Change priority of all jobs in the queue.
- -n schedd-name
- Change priority of jobs queued at the specified condor_schedd in the local pool.
- -pool pool-name
- Specify the pool containing the condor_schedd.
- cluster
- Change priority for all jobs in the specified cluster.
- cluster.proc
- Change priority for a specific job.
- username
- Change priority for all jobs belonging to the specified user.
EXAMPLES¶
Set job 123.0 to priority 10:
$ condor_prio -p 10 123.0
Increase priority of all jobs in cluster 456 by 5:
$ condor_prio +5 456
Decrease priority of all jobs belonging to user alice by 3:
$ condor_prio -3 alice
EXIT STATUS¶
0 - Success
1 - Failure
SEE ALSO¶
condor_submit <href="../man-pages/condor_submit.html">, condor_q <href="../man-pages/condor_q.html">, condor_userprio <href="../man-pages/condor_userprio.html">, condor_now <href="../man-pages/condor_now.html">
AVAILABILITY¶
Linux, MacOS, Windows
Author¶
HTCondor Team
Copyright¶
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.
| June 17, 2026 |