Name¶
condor_wait Wait - for jobs to finish
Synopsis¶
condor_wait [-help -version]
condor_wait[-debug] [-status] [-echo] [-wait seconds] [-num number-of-jobs]
log-file[job ID]
Description¶
condor_waitwatches a job event log file (created with the logcommand within a
submit description file) and returns when one or more jobs from the log have
completed or aborted.
Because condor_waitexpects to find at least one job submitted event in the log
file, at least one job must have been successfully submitted with
condor_submitbefore condor_waitis executed.
condor_waitwill wait forever for jobs to finish, unless a shorter wait time is
specified.
Options¶
-help
-
- Display usage information
-
-version
-
- Display version information
-
-debug
-
- Show extra debugging information.
-
-status
-
- Show job start and terminate information.
-
-echo
-
- Print the events out to stdout .
-
-wait seconds
-
- Wait no more than the integer number of seconds. The default is unlimited
time.
-
-num number-of-jobs
-
- Wait for the integer number-of-jobsjobs to end. The default is all jobs in
the log file.
-
log file
-
- The name of the log file to watch for information about the job.
-
job ID
-
- A specific job or set of jobs to watch. If the job IDis only the job
ClassAd attribute ClusterId , then condor_wait waits for all jobs with the
given ClusterId . If the job IDis a pair of the job ClassAd attributes,
given by ClusterId . ProcId , then condor_wait waits for the specific job
with this job ID. If this option is not specified, all jobs that exist in
the log file when condor_wait is invoked will be watched.
-
-
condor_waitis an inexpensive way to test or wait for the completion of a job or
a whole cluster, if you are trying to get a process outside of HTCondor to
synchronize with a job or set of jobs.
It can also be used to wait for the completion of a limited subset of jobs, via
the -numoption.
Examples¶
condor_wait logfile
This command waits for all jobs that exist in logfile to complete.
condor_wait logfile 40
This command waits for all jobs that exist in logfile with a job ClassAd
attribute ClusterId of 40 to complete.
condor_wait -num 2 logfile
This command waits for any two jobs that exist in logfile to complete.
condor_wait logfile 40.1
This command waits for job 40.1 that exists in logfile to complete.
condor_wait -wait 3600 logfile 40.1
This waits for job 40.1 to complete by watching logfile , but it will not wait
more than one hour (3600 seconds).
Exit Status¶
condor_waitexits with 0 if and only if the specified job or jobs have completed
or aborted. condor_waitreturns 1 if unrecoverable errors occur, such as a
missing log file, if the job does not exist in the log file, or the
user-specified waiting time has expired.
Author¶
Center for High Throughput Computing, University of Wisconsin-Madison
Copyright¶
Copyright (C) 1990-2014 Center for High Throughput Computing, Computer Sciences
Department, University of Wisconsin-Madison, Madison, WI. All Rights Reserved.
Licensed under the Apache License, Version 2.0.
