bjobs - get information about batch jobs in the lsbatch system
bjobs [ -h ] [ -V ] [ -w | -l ] [ -a ] [ -d ] [ -p ] [ -s ] [ -N host_spec
]
[ -q queue_name ] [ -m host_name ] [ -u user_name | all ] [
-J job_name ]
[ jobId ... ]
Display the status and other information about the batch jobs that are specified by the options. If no option is specified, then the default is to display information about all the unfinished (that is, pending, running and suspended) jobs of the user who invoked this command.
If you specify the -d or -a option, then jobs that have finished within the last CLEAN_PERIOD seconds can be displayed (see the description of the lsbatch configuration file lsb.params in lsbatch(5) ). For jobs finished more than CLEAN_PERIOD seconds ago, the bhist command can be used to display their information.
Pending jobs are displayed in the order in which they will be considered for dispatch. Jobs in higher priority queues are displayed before those in lower priority queues. Pending jobs in the same priority queue(s) are displayed in the order in which they were submitted but this order can be changed by using the commands btop or bbot (see btop(1) ). If more than one job is dispatched to a host, the jobs on that host are listed in the order in which they will be considered for scheduling on this host by their queue priorities and dispatch times. Finished jobs are displayed in the order in which they were completed.
A listing of jobs is displayed with the following fields:
JOBID
the job ID that the lsbatch system assigned to the job.
USER the user who submitted the job.
STAT The current status of the job (see JOB STATUS).
QUEUE
The name of the job queue to which the job belongs.
FROM The name of the host from which the job was submitted.
EXEC_HOST
The name of one or more hosts on which the job is executing (this
field is empty if the job has not been dispatched).
JOB_NAME
The job name assigned by the user, or the command string assigned by
default (see bsub(1)
).Ifthejobname only the last characters are
displayed.
SUBMIT_TIME
The submission time of the job.
Possible values for the status of a job include:
PEND The job is pending, that is, it has not yet been started.
PSUSP
The job has been suspended, either by its owner or the LSF administrator,
while pending.
RUN the job is currently running.
USUSP
The job has been suspended, either by its owner or the LSF administrator,
while running.
SSUSP
The job has been suspended by the lsbatch system while running because
of one of the following:
The load conditions on the execution host or hosts have exceeded a
threshold according to the loadStop vector defined for the host or
queue;
the run window of the host or queue has expired. (see bqueues(1)
,
hosts(1)
, and lsbatch(5)
).
DONE The job has terminated with status of 0.
EXIT The job has terminated with a non-zero status - it may have been aborted due to an error in its execution, or killed by its owner or the LSF administrator.
UNKWN
The slave batch daemon (sbatchd) on the host on which the job is being
processed has lost contact with the master batch daemon (mbatchd).
-h Print command usage to stderr and exit.
-V Print LSF release version to stderr and exit.
-w Display job information in a wide format. Fields are displayed without truncation.
-l Display detailed information for each job in a (long) multi-line format. See also bhist(1) .
-a Display information about all jobs, including unfinished jobs (pending, running or suspended) and recently finished jobs. lsbatch remembers jobs that have finished within a period up to now (the default period is 1 hour). This time parameter is configurable (see lsbatch(5) for CLEAN_PERIOD). If neither -a nor -d is present, then finished jobs are not displayed.
-d Display only the recently finished jobs. For the default, see -a.
-p Display only the pending jobs, showing the reason why each job was not dispatched during the last dispatch turn. Note that these reasons are only the contributing factors preventing the job from being dispatched. It is possible that some reasons shown do not apply to a particular job, but at least one of the reasons prevented the job from being dispatched. The reasons could be as old as the configuration parameter MBD_SLEEP_TIME seconds (see lsbatch(5) ). So the reasons shown may not agree with the current load situation.
-s Display only the suspended jobs, showing the reason why each job was suspended. Note that the suspending reason is recorded when the job is suspended. It may not explain why the job is still suspended. For example, the job may have been suspended because of paging rate, but after the paging rate decreased another load index could prevent the job from resuming. The suspending reason will continue to show paging rate. The suspending reason does not change until the job is resumed and suspended again. The reasons could be as old as the configuration parameter SBD_SLEEP_TIME (see lsbatch(5) ). So the reasons shown may not agree with the current load situation.
-N host_spec
Display CPU time consumed by the job, using a normalized value.
host_spec is either a host name, or a host model name defined in LSF,
or a CPU factor (use lsinfo(1)
to get host model and CPU factor information).
The appropriate CPU scaling factor for the specified
host_spec is used to normalize the actual CPU time consumed by the
job.
-q queue_name
Display jobs that are in the queue queue_name. The command bqueues
returns a list of queues configured in the system and information
about the configurations of these queues.
-m host_name
Display jobs that have been dispatched to the host or host group
specified by host_name. To determine the available batch server hosts
and host groups, use the commands bhosts and bmgroup, respectively.
-u user_name | all
Display jobs that have been submitted by the user or the user group
(see bugroup(1)
) specified by user_name, or by all users (if the
reserved user name all is specified). The default is to display the
jobs submitted by the user who invoked this command.
-J job_name
Display the jobs that have the specified job_name.
jobId ...
Display the job or jobs with the specified jobId ... . The value 0
for jobId is ignored.
% bjobs -pl
Display detailed info of all pending jobs of the invoker.
% bjobs -ps
Display only pending and suspended jobs.
% bjobs -u all -a
Display all jobs of all users.
% bjobs -d -q short -m apple -u john
Display all the recently finished jobs submitted by john to the queue
short, and executed on the host apple.
% bjobs 101 102 203 509
Display jobs with jobID 101, 102, 203, and 509.
lsbatch(1) , bsub(1) , bhosts(1) , bmgroup(1) , bqueues(1) bhist(1) , lsbatch(5) , mbatchd(8)