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

Name

6       condor_wait Wait for jobs to finish
7

Synopsis

9       condor_wait [ -help -version ]
10
11       condor_wait  [  -debug ] [ -status ] [ -echo ] [ -wait seconds ] [ -num
12       number-of-jobs ] log-file [ job ID ]
13

Description

15       condor_wait watches a job event log file (created with the log  command
16       within  a  submit  description  file) and returns when one or more jobs
17       from the log have completed or aborted.
18
19       Because condor_wait expects to find at least one job submitted event in
20       the  log  file,  at least one job must have been successfully submitted
21       with condor_submit before condor_wait is executed.
22
23       condor_wait will wait forever for jobs to finish, unless a shorter wait
24       time is specified.
25

Options

27       -help
28
29          Display usage information
30
31
32
33       -version
34
35          Display version information
36
37
38
39       -debug
40
41          Show extra debugging information.
42
43
44
45       -status
46
47          Show job start and terminate information.
48
49
50
51       -echo
52
53          Print the events out to  stdout .
54
55
56
57       -wait seconds
58
59          Wait  no  more  than  the integer number of seconds . The default is
60          unlimited time.
61
62
63
64       -num number-of-jobs
65
66          Wait for the integer number-of-jobs jobs to end. The default is  all
67          jobs in the log file.
68
69
70
71       log file
72
73          The name of the log file to watch for information about the job.
74
75
76
77       job ID
78
79          A  specific  job  or set of jobs to watch. If the job ID is only the
80          job ClassAd attribute  ClusterId , then condor_wait  waits  for  all
81          jobs  with the given  ClusterId . If the job ID is a pair of the job
82          ClassAd attributes, given by  ClusterId . ProcId , then  condor_wait
83          waits  for the specific job with this job ID . If this option is not
84          specified, all jobs that exist in the log file when  condor_wait  is
85          invoked will be watched.
86
87
88
89
90

General Remarks

92       condor_wait is an inexpensive way to test or wait for the completion of
93       a job or a whole cluster, if you are trying to get a process outside of
94       HTCondor to synchronize with a job or set of jobs.
95
96       It  can  also be used to wait for the completion of a limited subset of
97       jobs, via the -num option.
98

Examples

100       condor_wait logfile
101
102       This command waits for all jobs that exist in  logfile to complete.
103
104       condor_wait logfile 40
105
106       This command waits for all jobs that exist in  logfile with a job Clas‐
107       sAd attribute  ClusterId of 40 to complete.
108
109       condor_wait -num 2 logfile
110
111       This command waits for any two jobs that exist in  logfile to complete.
112
113       condor_wait logfile 40.1
114
115       This command waits for job 40.1 that exists in  logfile to complete.
116
117       condor_wait -wait 3600 logfile 40.1
118
119       This  waits for job 40.1 to complete by watching  logfile , but it will
120       not wait more than one hour (3600 seconds).
121

Exit Status

123       condor_wait exits with 0 if and only if the specified job or jobs  have
124       completed  or  aborted.   condor_wait returns 1 if unrecoverable errors
125       occur, such as a missing log file, if the job does not exist in the log
126       file, or the user-specified waiting time has expired.
127

Author

129       Center for High Throughput Computing, University of Wisconsin-Madison
130

132       Copyright  (C) 1990-2018 Center for High Throughput Computing, Computer
133       Sciences Department, University of Wisconsin-Madison, Madison, WI.  All
134       Rights Reserved. Licensed under the Apache License, Version 2.0.
135
136
137
138                                     date        just-man-pages/condor_wait(1)
Impressum