GBCH-GOADV(1)

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.