.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "CONDOR_QEDIT" "1" "Apr 01, 2024" "" "HTCondor Manual"
.SH NAME
condor_qedit \- HTCondor Manual
.sp
modify job attributes
  
.SH SYNOPSIS
.sp
\fBcondor_qedit\fP [\fB\-debug\fP ] [\fB\-n\fP \fIschedd\-name\fP]
[\fB\-pool\fP \fIpool\-name\fP] [\fB\-forward\fP ] \fI{cluster | cluster.proc | owner |
\-constraint constraint}\fP \fIedit\-list\fP
.SH DESCRIPTION
.sp
\fIcondor_qedit\fP 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 \fIedit\-list\fP can take one of 3 forms
.INDENT 0.0
.IP \(bu 2
.INDENT 2.0
.TP
.B \fIattribute\-name\fP \fIattribute\-value\fP \fI\&...\fP
This is the older form, which behaves the same as the format below.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B \fIattribute\-name=attribute\-value\fP \fI\&...\fP
The \fIattribute\-value\fP 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.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
\fB\-edits[:auto|long|xml|json|new]\fP \fIfile\-name\fP
The file indicated by \fIfile\-name\fP is read as a classad of the given format.
If no format is specified or \fBauto\fP is specified the format will be detected.
if \fIfile\-name\fP is \fB\-\fP standard input will be read.
.UNINDENT
.UNINDENT
.sp
To ensure security and correctness, \fIcondor_qedit\fP will not allow
modification of the following ClassAd attributes:
.INDENT 0.0
.IP \(bu 2
\fBOwner\fP
.IP \(bu 2
\fBClusterId\fP
.IP \(bu 2
\fBProcId\fP
.IP \(bu 2
\fBMyType\fP
.IP \(bu 2
\fBTargetType\fP
.IP \(bu 2
\fBJobStatus\fP
.UNINDENT
.sp
Since \fBJobStatus\fP may not be changed with \fIcondor_qedit\fP, use
\fIcondor_hold\fP to place a job in the hold state, and use
\fIcondor_release\fP to release a held job, instead of attempting to modify
\fBJobStatus\fP directly.
.sp
If a job is currently running, modified attributes for that job will not
affect the job until it restarts. As an example, for \fBPeriodicRemove\fP
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
\fBPeriodicHold\fP and \fBPeriodicRelease\fP\&.
.sp
\fIcondor_qedit\fP 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.
.SH OPTIONS
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
\fB\-debug\fP
Causes debugging information to be sent to \fBstderr\fP, based on the
value of the configuration variable \fI\%TOOL_DEBUG\fP\&.
.TP
\fB\-n\fP \fIschedd\-name\fP
Modify job attributes in the queue of the specified schedd
.TP
\fB\-pool\fP \fIpool\-name\fP
Modify job attributes in the queue of the schedd specified in the
specified pool
.TP
\fB\-forward\fP
Forward modifications to shadow/gridmanager
.UNINDENT
.UNINDENT
.UNINDENT
.SH EXAMPLES
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ condor_qedit \-name north.cs.wisc.edu \-pool condor.cs.wisc.edu 249.0 answer 42
Set attribute \(dqanswer\(dq.
$ condor_qedit \-name perdita 1849.0 In \(aq\(dqmyinput\(dq\(aq
Set attribute \(dqIn\(dq.
% condor_qedit jbasney OnExitRemove=FALSE
Set attribute \(dqOnExitRemove\(dq.
% condor_qedit \-constraint \(aqJobUniverse == 1\(aq \(aqRequirements=(Arch == \(dqINTEL\(dq) && (OpSys == \(dqSOLARIS26\(dq) && (Disk >= ExecutableSize) && (VirtualMemory >= ImageSize)\(aq
Set attribute \(dqRequirements\(dq.
.EE
.UNINDENT
.UNINDENT
.SH GENERAL REMARKS
.sp
A job\(aqs ClassAd attributes may be viewed with
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ condor_q \-long
.EE
.UNINDENT
.UNINDENT
.SH EXIT STATUS
.sp
\fIcondor_qedit\fP will exit with a status value of 0 (zero) upon success,
and it will exit with the value 1 (one) upon failure.
.SH AUTHOR
HTCondor Team
.SH 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.
.\" Generated by docutils manpage writer.
.