1CONDOR_QEDIT(1)                 HTCondor Manual                CONDOR_QEDIT(1)
2
3
4

NAME

6       condor_qedit - HTCondor Manual
7
8       modify job attributes
9
10

SYNOPSIS

12       condor_qedit  [-debug  ]  [-n schedd-name] [-pool pool-name] {cluster |
13       cluster.proc | owner | -constraint  constraint}  attribute-name  attri‐
14       bute-value ...
15

DESCRIPTION

17       condor_qedit  modifies  job ClassAd attributes of queued HTCondor jobs.
18       The jobs are specified either by cluster number, job ID, owner, or by a
19       ClassAd  constraint  expression. The attribute-value may be any ClassAd
20       expression. String expressions must be  surrounded  by  double  quotes.
21       Multiple attribute value pairs may be listed on the same command line.
22
23       To ensure security and correctness, condor_qedit will not allow modifi‐
24       cation of the following ClassAd attributes:
25
26       • Owner
27
28       • ClusterId
29
30       • ProcId
31
32       • MyType
33
34       • TargetType
35
36       • JobStatus
37
38       Since JobStatus may not be changed with condor_qedit,  use  condor_hold
39       to  place  a job in the hold state, and use condor_release to release a
40       held job, instead of attempting to modify JobStatus directly.
41
42       If a job is currently running, modified attributes for  that  job  will
43       not affect the job until it restarts. As an example, for PeriodicRemove
44       to affect when a currently running job will be removed from the  queue,
45       that  job  must  first  be  evicted  from a machine and returned to the
46       queue.  The same is true for other periodic expressions, such as  Peri‐
47       odicHold and PeriodicRelease.
48
49       condor_qedit  validates  both  attribute  names  and  attribute values,
50       checking for correct ClassAd syntax. An error message is  printed,  and
51       no attribute is set or changed if the name or value is invalid.
52

OPTIONS

54          -debug Causes  debugging  information to be sent to stderr, based on
55                 the value of the configuration variable TOOL_DEBUG.
56
57          -n schedd-name
58                 Modify job attributes in the queue of the specified schedd
59
60          -pool pool-name
61                 Modify job attributes in the queue of the schedd specified in
62                 the specified pool
63

EXAMPLES

65          % condor_qedit -name north.cs.wisc.edu -pool condor.cs.wisc.edu 249.0 answer 42
66          Set attribute "answer".
67          % condor_qedit -name perdita 1849.0 In '"myinput"'
68          Set attribute "In".
69          % condor_qedit jbasney NiceUser TRUE
70          Set attribute "NiceUser".
71          % condor_qedit -constraint 'JobUniverse == 1' Requirements '(Arch == "INTEL") && (OpSys == "SOLARIS26") && (Disk >= ExecutableSize) && (VirtualMemory >= ImageSize)'
72          Set attribute "Requirements".
73

GENERAL REMARKS

75       A job's ClassAd attributes may be viewed with
76
77          condor_q -long
78

EXIT STATUS

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

AUTHOR

84       HTCondor Team
85

87       1990-2022, Center for High Throughput Computing, Computer Sciences  De‐
88       partment,  University  of  Wisconsin-Madison, Madison, WI, US. Licensed
89       under the Apache License, Version 2.0.
90
91
92
93
948.8                              Jan 19, 2022                  CONDOR_QEDIT(1)
Impressum