1just-man-pages/condor_hold(1)General Commands Manuajlust-man-pages/condor_hold(1)
2
3
4
6 condor_hold put jobs in the queue into the hold state
7
9 condor_hold [ -help -version ]
10
11 condor_hold [ -debug ] [ -reason reasonstring ] [ -subcode number ] [
12 -pool centralmanagerhostname[:portnumber] -name scheddname ][ -addr
13 <a.b.c.d:port> ] cluster...cluster.process...user... -constraint
14 expression ...
15
16 condor_hold [ -debug ] [ -reason reasonstring ] [ -subcode number ] [
17 -pool centralmanagerhostname[:portnumber] -name scheddname ][ -addr
18 <a.b.c.d:port> ] -all
19
21 condor_hold places jobs from the HTCondor job queue in the hold state.
22 If the -name option is specified, the named condor_schedd is targeted
23 for processing. Otherwise, the local condor_schedd is targeted. The
24 jobs to be held are identified by one or more job identifiers, as
25 described below. For any given job, only the owner of the job or one of
26 the queue super users (defined by the QUEUE_SUPER_USERS macro) can
27 place the job on hold.
28
29 A job in the hold state remains in the job queue, but the job will not
30 run until released with condor_release .
31
32 A currently running job that is placed in the hold state by condor_hold
33 is sent a hard kill signal. For a standard universe job, this means
34 that the job is removed from the machine without allowing a checkpoint
35 to be produced first.
36
38 -help
39
40 Display usage information
41
42
43
44 -version
45
46 Display version information
47
48
49
50 -pool centralmanagerhostname[:portnumber]
51
52 Specify a pool by giving the central manager's host name and an
53 optional port number
54
55
56
57 -name scheddname
58
59 Send the command to a machine identified by scheddname
60
61
62
63 -addr <a.b.c.d:port>
64
65 Send the command to a machine located at <a.b.c.d:port>
66
67
68
69 -debug
70
71 Causes debugging information to be sent to stderr , based on the
72 value of the configuration variable TOOL_DEBUG .
73
74
75
76 -reason reasonstring
77
78 Sets the job ClassAd attribute HoldReason to the value given by
79 reasonstring . reasonstring will be delimited by double quote marks
80 on the command line, if it contains space characters.
81
82
83
84 -subcode number
85
86 Sets the job ClassAd attribute HoldReasonSubCode to the integer
87 value given by number .
88
89
90
91 cluster
92
93 Hold all jobs in the specified cluster
94
95
96
97 cluster.process
98
99 Hold the specific job in the cluster
100
101
102
103 user
104
105 Hold all jobs belonging to specified user
106
107
108
109 -constraint expression
110
111 Hold all jobs which match the job ClassAd expression constraint
112 (within quotation marks). Note that quotation marks must be escaped
113 with the backslash characters for most shells.
114
115
116
117 -all
118
119 Hold all the jobs in the queue
120
121
122
123
124
126 condor_release
127
129 To place on hold all jobs (of the user that issued the condor_hold com‐
130 mand) that are not currently running:
131
132 % condor_hold -constraint "JobStatus!=2"
133
134 Multiple options within the same command cause the union of all jobs
135 that meet either (or both) of the options to be placed in the hold
136 state. Therefore, the command
137
138 % condor_hold Mary -constraint "JobStatus!=2"
139
140 places all of Mary's queued jobs into the hold state, and the con‐
141 straint holds all queued jobs not currently running. It also sends a
142 hard kill signal to any of Mary's jobs that are currently running. Note
143 that the jobs specified by the constraint will also be Mary's jobs, if
144 it is Mary that issues this example condor_hold command.
145
147 condor_hold will exit with a status value of 0 (zero) upon success, and
148 it will exit with the value 1 (one) upon failure.
149
151 Center for High Throughput Computing, University of Wisconsin-Madison
152
154 Copyright (C) 1990-2018 Center for High Throughput Computing, Computer
155 Sciences Department, University of Wisconsin-Madison, Madison, WI. All
156 Rights Reserved. Licensed under the Apache License, Version 2.0.
157
158
159
160 date just-man-pages/condor_hold(1)