Description
.qbremove requests the Supervisor to remove a list of jobs.
Usage
qbremove [options] jobID… | 0
where JobID is one or more job IDs, and 0 is a wild card token representing all the user's jobs.
Options
Option | Description |
---|---|
--failed | Remove failed jobs |
--killed | Remove killed jobs |
--complete | Remove complete jobs |
--done | Remove done (complete,killed,failed) jobs |
--pending | Remove pending jobs (admin only) |
--running | Remove running jobs (admin only) |
--active | Remove active (running,pending,blocked) jobs (admin only) |
--user string | Remove jobs for user string |
--type string --prototype string | Remove jobs with string type |
--status string | Remove jobs with string status (ex. pending) |
--name string | Remove jobs with string name |
--kind string | Remove jobs of string kind |
--pid int | Remove jobs with process ID int |
--pgrp int | Remove jobs in int process group |
--priority int | Remove jobs with int priority |
--cluster string | Remove jobs in string cluster |
--cpus int | Remove jobs with a total of int subjobs |
--xml | Output in XML format |
--help | Command help |
--version | Command version |
Notes
This command only works on jobs which are considered complete, unless the use has the Qube 'admin' privilige, in which case the user could conceivably remove all jobs in queue.
For non-admin users, jobs which are still pending or running will be ignored. (ex. pending, running, blocked, suspended).
Refer to User Permissions or qbusers for more detail on the Qube! permission scheme.
Examples
Remove job 12345:
% qbremove 12345
Remove all of user anthony's jobs:
% qbremove --user anthony 0
See also