Scroll to navigation

CONDOR_WAIT(1) HTCondor Manual CONDOR_WAIT(1)

NAME

condor_wait - HTCondor Manual

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_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 before condor_wait is executed.

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

OPTIONS

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, then condor_wait waits for all jobs with the given ClusterId. If the job ID is 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.



GENERAL REMARKS

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.

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_wait exits with 0 if and only if the specified job or jobs have completed or aborted. condor_wait returns 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

HTCondor Team

COPYRIGHT

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

August 3, 2024