Ubuntu Manpages

condor_wait

HTCondor Manual Wait for HTCondor jobs to finish.

condor_wait [-help | -version]

condor_wait [-debug] [-status] [-echo] [-wait seconds] [-num number-of-jobs] log-file [job-ID]

condor_wait watches a job event log file (created with the log command within a submit description file) and returns when one or more jobs from the log have completed or aborted.

Because condor_wait expects to find at least one job submitted event in the log file, at least one job must have been successfully submitted with condor_submit <href="../man-pages/condor_submit.html"> before condor_wait is executed.

condor_wait will wait forever for jobs to finish, unless a shorter wait time is specified.

Display usage information.
Display version information.
Show extra debugging information.
Show job start and terminate information.
Print the events out to stdout.
Wait no more than the integer number of seconds. The default is unlimited time.
Wait for the integer number-of-jobs jobs to end. The default is all jobs in the log file.
The name of the log file to watch for information about the job.
A specific job or set of jobs to watch. If the job-ID is only the job ClassAd attribute ClusterId <href="../classad-attributes/job-classad-attributes.html#ClusterId">, then condor_wait waits for all jobs with the given ClusterId <href="../classad-attributes/job-classad-attributes.html#ClusterId">. If the job-ID is a pair of the job ClassAd attributes, given by ClusterId <href="../classad-attributes/job-classad-attributes.html#ClusterId">.ProcId <href="../classad-attributes/job-classad-attributes.html#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_wait is 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 -num option.

Wait for all jobs in a log file to complete:

$ condor_wait logfile


Wait for all jobs in cluster 40 to complete:

$ condor_wait logfile 40


Wait for any two jobs to complete:

$ condor_wait -num 2 logfile


Wait for a specific job to complete:

$ condor_wait logfile 40.1


Wait for job 40.1 with a one hour timeout:

$ condor_wait -wait 3600 logfile 40.1


0 - Success (specified job or jobs have completed or aborted)

1 - Failure (unrecoverable errors such as missing log file, non-existent job, or timeout expired)

condor_submit <href="../man-pages/condor_submit.html">, condor_q <href="../man-pages/condor_q.html">, condor_history <href="../man-pages/condor_history.html">

Linux, MacOS, Windows

HTCondor Team

1990-2026, Center for High Throughput Computing, Computer Sciences Department, University of Wisconsin-Madison, Madison, WI, US. Licensed under the Apache License, Version 2.0.