NAME

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.


SYNOPSIS

gbch-jdel [ -options ] job number ...


DESCRIPTION

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.


OPTIONS

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.

-? or +explain

causes a summary of the other options to be displayed without taking further action.

-C name or +command-prefix name

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.

-D name or +directory name

Save unqueued jobs to name rather than the current directory when gbch-jdel is invoked.

-d or +delete

Cancel any previous -k option to be the default of deleting jobs.

-e or +do-not-unqueue

Cancel the effect of a previous -u option.

-J name or +job-prefix name

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).

-K signalnumber or +signal-number signalnumber

Apply signalnumber given to kill running job. Default is 15 (SIGTERM).

-k or +do-not-delete

Kill jobs only where applicable, do not delete.

-n or -N or +no-force

Do not kill or delete running jobs (default).

-S seconds or +sleep-time seconds

Monitor process state for seconds seconds after killing (default 10 seconds).

-u or +unqueue

unqueue job(s) to the current directory. Do not delete if -k given.

-y or -Y or +force

Kill and delete running jobs.

+freeze-current

Save all the current options in a .gnubatch file in the current directory.

+freeze-home

Save all the current options in a .gnubatch file in the user's home directory.


FILES

~/.gnubatch configuration file (home directory)

.gnubatch configuration file (current directory)

btrest.help message file


ENVIRONMENT

GBCH_JDEL

space-separated options to override defaults for gbch_jdel

GBCH_GO

space-separated options to override defaults for gbch_go

GBCH_GOADV

space-separated options to override defaults for gbch_goadv

GBCH_ADV

space-separated options to override defaults for gbch_adv

BTRESTCONF

location of alternative help file.


EXAMPLES

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


SEE ALSO

btsyntax(5), gnubatch.conf(5), gnubatch.hosts(5), gbch-r(1), gbch-rr(1), gbch-jchange(1), gbch-jlist(1).


DIAGNOSTICS

Various diagnostics are read and printed as required from the message file btrest.help.


COPYRIGHT

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.


AUTHOR

John M Collins, Xi Software Ltd.