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] [-forward ]
13       {cluster | cluster.proc | owner | -constraint constraint} edit-list
14

DESCRIPTION

16       condor_qedit modifies job ClassAd attributes of queued  HTCondor  jobs.
17       The jobs are specified either by cluster number, job ID, owner, or by a
18       ClassAd constraint expression. The edit-list can take one of 3 forms
19
20       •
21
22         attribute-name attribute-value ...
23                This is the older form, which behaves the same as  the  format
24                below.
25
26       •
27
28         attribute-name=attribute-value ...
29                The  attribute-value may be any ClassAd expression. String ex‐
30                pressions must be surrounded by double quotes.   Multiple  at‐
31                tribute value pairs may be listed on the same command line.
32
33       •
34
35         -edits[:auto|long|xml|json|new] file-name
36                The  file  indicated  by file-name is read as a classad of the
37                given format.  If no format is specified or auto is  specified
38                the format will be detected.  if file-name is - standard input
39                will be read.
40
41       To ensure security and correctness, condor_qedit will not allow modifi‐
42       cation of the following ClassAd attributes:
43
44       • Owner
45
46       • ClusterId
47
48       • ProcId
49
50       • MyType
51
52       • TargetType
53
54       • JobStatus
55
56       Since  JobStatus  may not be changed with condor_qedit, use condor_hold
57       to place a job in the hold state, and use condor_release to  release  a
58       held job, instead of attempting to modify JobStatus directly.
59
60       If  a  job  is currently running, modified attributes for that job will
61       not affect the job until it restarts. As an example, for PeriodicRemove
62       to  affect when a currently running job will be removed from the queue,
63       that job must first be evicted from  a  machine  and  returned  to  the
64       queue.   The same is true for other periodic expressions, such as Peri‐
65       odicHold and PeriodicRelease.
66
67       condor_qedit validates  both  attribute  names  and  attribute  values,
68       checking  for  correct ClassAd syntax. An error message is printed, and
69       no attribute is set or changed if any name or value is invalid.
70

OPTIONS

72          -debug Causes debugging information to be sent to stderr,  based  on
73                 the value of the configuration variable TOOL_DEBUG.
74
75          -n schedd-name
76                 Modify job attributes in the queue of the specified schedd
77
78          -pool pool-name
79                 Modify job attributes in the queue of the schedd specified in
80                 the specified pool
81
82          -forward
83                 Forward modifications to shadow/gridmanager
84

EXAMPLES

86          $ condor_qedit -name north.cs.wisc.edu -pool condor.cs.wisc.edu 249.0 answer 42
87          Set attribute "answer".
88          $ condor_qedit -name perdita 1849.0 In '"myinput"'
89          Set attribute "In".
90          % condor_qedit jbasney OnExitRemove=FALSE
91          Set attribute "OnExitRemove".
92          % condor_qedit -constraint 'JobUniverse == 1' 'Requirements=(Arch == "INTEL") && (OpSys == "SOLARIS26") && (Disk >= ExecutableSize) && (VirtualMemory >= ImageSize)'
93          Set attribute "Requirements".
94

GENERAL REMARKS

96       A job's ClassAd attributes may be viewed with
97
98          $ condor_q -long
99

EXIT STATUS

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

AUTHOR

105       HTCondor Team
106

108       1990-2023,  Center for High Throughput Computing, Computer Sciences De‐
109       partment, University of Wisconsin-Madison, Madison,  WI,  US.  Licensed
110       under the Apache License, Version 2.0.
111
112
113
114
115                                 Oct 02, 2023                  CONDOR_QEDIT(1)
Impressum