NAME

       gspl-qdel - delete spool jobs

SYNOPSIS

       gspl-qdel [ -options ] job number ...

DESCRIPTION

       gspl-qdel deletes one or more jobs from the GNUspool job spool queue, which may be on the
       local host or other hosts on the network. Jobs are specified by the job number, which is
       reported by gspl-qlist(1) in the first column of the default output, or by gspl-pr(1) or
       gspl-rpr(1) when the job is queued with the verbose option. Remote jobs are specified by
       prefixing the job number by the host name and a colon, thus "host:1234". Leading zeroes in
       the job number may be omitted.

       Gspl-qdel will not delete jobs not marked as "printed" unless the -y option is given.

OPTIONS

       Note that the order of treatment, letters and keywords described below may be modified by
       editing the file rest.help - see spsyntax(5).  The environment variable on which options
       are supplied is "GSPL_QDEL" and the environment variable to specify the help file is
       "SPRESTCONF".

       -? or +explain
           causes a summary of the other options to be displayed without taking further action.

       -C nnnn or +classcode nnnn
           may be used to set a class code to narrow or expand the range of jobs from which jobs
           are selected. It is probably only relevant where the user has override class privilege
           and it is required to expand the default class code to select additional jobs.

       -d or +delete
           cancel a previously-specified -k option.

       -D name or +directory name
           Save unqueued jobs to name rather than the current directory.

       -e or +do-not-unqueue
           cancel a previously-specified -u option. The jobs will just be deleted, not unqueued.

       -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 or +do-not-delete
           when performing an unqueue as specified with the -u option, do not delete the job at
           the end.

       -n or +keep-unprinted
           is the default case. Jobs which have not yet been printed are not deleted.

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

       -u or +unqueue
           unqueue jobs, i.e. copy to current directory or directory selected with the -D option.
           Jobs are copied as two files, a job file containing the text of the job and a command
           file containing an gspl-pr command. The command file may be run as a shell script to
           re-queue the job with the same options.

       -y or +delete-unprinted
           cancels all jobs, whether printed or not.

       +freeze-current
           Save all the current options in a .gnuspool file in the current directory. If there
           are no jobs given to operate on and this is specified, then gspl-qdel will quit
           without error. If it is unable to save the options and jobs are specified, then gspl-
           qdel will continue.

       +freeze-home
           Save all the current options in a .gnuspool file in the user's home directory. If
           there are no jobs given to operate on and this is specified, then gspl-qdel will quit
           without error. If it is unable to save the options and jobs are specified, then gspl-
           qdel will continue.

FILES

       ~/.gnuspool configuration file (home directory)

        .gnuspool configuration file (current directory)

       rest.help message file

ENVIRONMENT

       GSPL_QDEL
           space-separated options to override defaults.

       SPRESTCONF
           location of alternative help file.

SEE ALSO

       gspl-rpr(1), gspl-pr(1), gspl-pq(1), gspl-qchange(1), gspl-qlist(1), spsyntax(5),
       gnuspool.conf(5), gnuspool.hosts(5).

DIAGNOSTICS

       Various diagnostics are read and printed as required from the message file, by default
       rest.help.

NOTES

       The -C option selects the class code for finding the jobs; if you have override class
       privilege, but your default class code does not allow the jobs "to be seen" in the output
       of gspl-qlist(1), then you may need to specify this.

       Any errors are reported with appropriate messages on standard error. If any errors are
       detected operating on several jobs, the exit code will correspond to the last such error
       displayed.

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.