gbch-jdel - delete batch jobs
gbch-go - force job(s) to run ignoring time
gbch-goadv - force job(s) to run ignoring time and advance time.
gbch-adv - advance job(s) to next time without running.
gbch-jdel [ -options ] job number ...
gbch-jdel provides a means of deleting batch jobs from the shell or a program, optionally killing running jobs if required.
gbch-go forces a job or jobs to run, ignoring the "next run time". Conditions and load level constraints are however still enforced. The "next run time" will not be affected when the job completes. This inserts an extra run of the job.
gbch-jgoadv forces a job or jobs to run, ignoring the "next run time". Conditions and load level constraints are however still enforced. The "next run time" is advanced to the next time. This brings forward the next run, thereafter resuming the sequence.
gbch-adv advances the run time on each job specified to the next run time according to its repeat time without running the job or looking at conditions.
The four programs are all hard links to the same file.
Jobs are specified by using the job number, as displayed by gbch-r(1) with the -v (verbose) option, or as in the output of the first column of the gbch-jlist(1) command with default format.
Remote jobs should be specified by prefixing the job numbers with the host name thus:
host:1234
It is not necessary to specify any leading zeros.
Appropriate error messages are displayed if the user attempts to delete a job which is either running or if the user does not have the necessary permissions.
Only gbch-jdel takes any options.
Note that the order of treatment, letters and keywords described below
may be modified by editing the file btrest.help -
see btsyntax(5)
.
The environment variable on which options are supplied is GBCH_JDEL
etc and the environment variable to specify the help file is
BTRESTCONF
.
causes a summary of the other options to be displayed without taking further action.
specify the given name as the prefix for the command file, followed by the job number, to be used by the -u option rather than the default of C (which in turn may be changed by editing the message file).
The command file is a shell script, typically containing a gbch-r(1) command, which when run via the shell will attempt to create a job equivalent to the one "unqueued". Obviously the user is at liberty to amend this or the job file before doing so.
Save unqueued jobs to name rather than the current directory when gbch-jdel is invoked.
Cancel any previous -k option to be the default of deleting jobs.
Cancel the effect of a previous -u option.
specify the given name as the prefix for the job file, followed by the job number, to be used by the -u option rather than the default of J (which in turn may be changed by editing the message file).
Apply signalnumber given to kill running job. Default is 15 (SIGTERM
).
Kill jobs only where applicable, do not delete.
Do not kill or delete running jobs (default).
Monitor process state for seconds seconds after killing (default 10 seconds).
unqueue job(s) to the current directory. Do not delete if -k given.
Kill and delete running jobs.
Save all the current options in a .gnubatch file in the current directory.
Save all the current options in a .gnubatch file in the user's home directory.
~/.gnubatch configuration file (home directory)
.gnubatch configuration file (current directory)
btrest.help message file
space-separated options to override defaults for gbch_jdel
space-separated options to override defaults for gbch_go
space-separated options to override defaults for gbch_goadv
space-separated options to override defaults for gbch_adv
location of alternative help file.
To delete jobs even if running:
gbch-jdel -y 1237 avon:9371
Kill a job without deleting it with signal 2 (SIGINT).
gbch-jdel -K 2 -k 9120
Take a copy of the job in a work directory without deleting it.
gbch-jdel -u -k -D ~/work -C spec -J script 9123
btsyntax(5)
,
gnubatch.conf(5),
gnubatch.hosts(5),
gbch-r(1),
gbch-rr(1),
gbch-jchange(1),
gbch-jlist(1).
Various diagnostics are read and printed as required from the message file btrest.help.
Copyright (c) 2009 Free Software Foundation, Inc. This is free software. You may redistribute copies of it under the terms of the GNU General Public License <http://www.gnu.org/licenses/gpl.html>. There is NO WARRANTY, to the extent permitted by law.
John M Collins, Xi Software Ltd.