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.

                                                  Aug 25, 2024                                   CONDOR_QEDIT(1)