condor_hold(1)

1just-man-pages/condor_hold(1)General Commands Manuajlust-man-pages/condor_hold(1)
2
3
4

Name

6       condor_hold put jobs in the queue into the hold state
7

Synopsis

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

Description

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

Options

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

Examples

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

Exit Status

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

Author

151       Center for High Throughput Computing, University of Wisconsin-Madison
152

Copyright

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)