Used to "shrink" the number of job instances running, without throwing away work performed.
qretire will request a job instance to release it host, and then go prematurely to "complete" state, even if there are pending agenda items. This command depends upon the job type and will only work if the job that is running supports a qube agenda based system.
qbretire [options] jobID… | 0
where JobID is one or more job IDs, and 0 is a wild card token representing all the user's jobs.
Retire work (default: on)
Retire subjobs (default: on)
Retire running jobs
Retire jobs for user string
--type string --prototype string
Retire jobs with string type
Retire jobs with string status (ex. pending)
Retire jobs with string name
Retire jobs of string kind
Retire jobs with process ID int
Retire jobs in int process group
Retire jobs with int priority
Retire jobs in string cluster
Retire jobs with a total of int subjobs
Output in XML format
This command only works on running jobs.
Retire only subjob 12354.0:
% qbretire 12354.0
Retire all subjobs in 12345:
% qbretire 12345
Retire all of user anthony's jobs:
% qbretire --user anthony 0
Retire all of user anthony's running jobs:
% qbretire --running --user anthony 0