condor_prio - Man Page

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, condor_q, condor_userprio, condor_now

Availability

Linux, MacOS, Windows

Author

HTCondor Team

Info

Aug 25, 2026 HTCondor Manual