NAME

       condor_qedit - HTCondor Manual

       modify job attributes

SYNOPSIS

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

DESCRIPTION

       condor_qedit modifies job ClassAd attributes  of  queued  HTCondor  jobs.   The  jobs  are
       specified  either by cluster number, job ID, owner, or by a ClassAd constraint expression.
       The edit-list can take one of 3 forms

       •

         attribute-name attribute-value ...
                This is the older form, which behaves the same as the format below.

       •

         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.

       •

         -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.

       To ensure security and correctness,  condor_qedit  will  not  allow  modification  of  the
       following ClassAd attributes:

       • Owner

       • ClusterId

       • ProcId

       • MyType

       • TargetType

       • JobStatus

       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.

       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.

       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.

OPTIONS

          -debug Causes  debugging  information  to  be sent to stderr, based on the value of the
                 configuration variable TOOL_DEBUG.

          -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

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".

GENERAL REMARKS

       A job's ClassAd attributes may be viewed with

          $ condor_q -long

EXIT STATUS

       condor_qedit will exit with a status value of 0 (zero) upon success, and it will exit with
       the value 1 (one) upon failure.

AUTHOR

       HTCondor Team

COPYRIGHT

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

                                           Apr 14, 2024                           CONDOR_QEDIT(1)