| [ Platform Documentation ] | [ Title ] | [ Contents ] | [ Previous ] | [ Next ] | [ Index ] |
bstop
suspends unfinished jobs
SYNOPSIS
bstop [-a] [-d] [-g job_group_name |-sla service_class_name]
[-J job_name] [-m host_name | -m host_group] [-q queue_name]
[-u user_name | -u user_group | -u all] [0]
[job_ID | "job_ID[index]"] ...
bstop [-h | -V]
DESCRIPTION
Suspends unfinished jobs.
Sends the SIGSTOP signal to sequential jobs and the SIGTSTP signal to parallel jobs to suspend them.
You must specify a job ID or -g, -J, -m, -u, or -q. You cannot suspend a job
that is already suspended. Specify job ID 0 (zero) to stop multiple jobs.
Only root and LSF administrators can operate on jobs submitted by other
users.
Use bresume to resume suspended jobs.
Using bstop on a job that is in the USUSP state has no effect.
You can also use bkill -s STOP to send the suspend signal to a job or use
bkill -s TSTP to suspend one or more parallel jobs. Use bkill -s CONT to
send a resume signal to a job.
If a signal request fails to reach the job execution host, LSF will retry the operation later when the host becomes reachable. LSF retries the most recent signal request.
OPTIONS
0
Suspends all the jobs that satisfy other options (-g, -m, -q, -u, and -J).
-a
Suspends all jobs.
-d
Suspends only finished jobs (with a DONE or EXIT status).
-g job_group_name
Suspends only on jobs in the job group specified by job_group_name.
You cannot use -g with -sla. A job can either be attached to a job group or
a service class, but not both.
-J job_name
Suspends only jobs with the specified name.
-m host_name | -m host_group
Suspends only jobs dispatched to the specified host or host group.
-q queue_name
Suspends only jobs in the specified queue.
-sla service_class_name
Suspends jobs belonging to the specified service class.
You cannot use -g with -sla. A job can either be attached to a job group or
a service class, but not both.
Use bsla to display the properties of service classes configured in
LSB_CONFDIR/cluster_name/configdir/lsb.serviceclasses (see
lsb.serviceclasses(5)) and dynamic information about the state of each
configured service class.
-u user_name | -u user_group | -u all
Suspends only jobs owned by the specified user or user group, or all users if
the keyword all is specified.
job_ID ... | "job_ID[index]" ...
Suspends only the specified jobs. Jobs submitted by any user can be specified
here without using the -u option.
-h
Prints command usage to stderr and exits.
-V
Prints LSF release version to stderr and exits.
EXAMPLES
% bstop 314
Suspends job number 314.
% bstop -m hostA
Suspends the invoker's last job that was dispatched to host hostA.
% bstop -u jsmith 0
Suspends all the jobs submitted by user jsmith.
% bstop -u all
Suspends the last submitted job in the LSF system.
% bstop -u all 0
Suspends all jobs for all users in the LSF system.
% bstop -g /risk_group/consolidate 0
Suspends all jobs in the job group /risk_group/consolidate.
SEE ALSO
bsub(1), bjobs(1), bqueues(1), bhosts(1), bresume(1), bkill(1), bgadd(1),
bgdel(1), bjgroup(1), bparams(5), mbatchd(8), kill(1), signal(2)
lsb.params(5)
[ Top ]
| [ Platform Documentation ] | [ Title ] | [ Contents ] | [ Previous ] | [ Next ] | [ Index ] |
|
Date Modified: February 24, 2004
Platform Computing: www.platform.com Platform Support: support@platform.com Platform Information Development: doc@platform.com Copyright © 1994-2004 Platform Computing Corporation. All rights reserved. |