nc wait
Wait for a specific job or list of jobs to complete, fail, or be forgotten.
nc: Usage Message
NC WAIT:
Wait for a specific job or list of jobs to complete,
fail, or be forgotten
USAGE:
% nc wait [OPTIONS] <jobId> ...
OPTIONS:
-h -- Print this message.
-q -- Quiet wait.
-v -- Verbose (may be repeated up to 3 times)
-dir <directory> -- Wait for all jobs in the given directory.
-subdirs <directory> -- Wait for all jobs in the given directory and
subdirectories.
-select <rule> -- Wait for all jobs in set defined by 'rule'.
The predicate 'isjob' is automatically added
to the rule.
-set <setName> -- Wait for all jobs in a set.
-start -- Wait for the specified jobs to start.
-p -- Use polling method (automatic delay)
-poll <MS> -- Use polling method with a delay of <MS>
milliseconds.
MS values are between 2000 and 60000.
-k -- Jobs are killed if you interrupt wait
by Ctrl-C.
-l -- Show log file of last job while waiting.
The log is shown either as it is created
if the job has been submitted with option -wl
or all at once upon job completion.
-maxwait <timespec> -- Specify a maximum wait time.
-timeout <timespec> -- Same as -maxwait
-jobinfo -- Show info about jobs being executed.
-callback <cmd> -- Execute 'cmd JOBID JOBSTATUS' for every job
that completes. Output to stdout.
Errors ignored.
-file <file> -- For experts. Source <file>, mostly to define
overrides for procedure VncWaitCallback
{ cmd jobId status }
RETURN:
0 -- All jobs are done, or started if -start is specified.
1 -- Some jobs are still invalid.
2 -- Some jobs are failed.
3 -- Some jobs have unexpected status.
4 -- Some jobs have been lost.
5 -- Waited for long enough (see -maxwait option)
EXAMPLES:
% nc wait 22345 22356
% nc wait -dir .
% nc wait -subdirs .
% nc wait -select "command~spice"
% nc wait -set "myset"
% nc wait -callback ./myScript -set myset
% nc wait -jobinfo -set myset
% nc wait -p -set myset
% nc wait -poll 5000 -set myset
% nc wait -maxwait 1m -set myset