Command Reference Guide

Platform LSF Command Reference 173
bstatus
gets current external job status or sets new job status
Synopsis
bstatus [-d "description"] job_ID | "job_ID[index]" | -J job_name
bstatus [-h | -V]
Description
Gets and displays the message description text of a job, or changes the contents of
the message description text with the
-d option. Always operates on the message
with index 0.
You can set the external status of a job until it completes. You cannot change the
status of done or exited jobs. You can display the status of a job until it is cleaned
from the system.
If a you specify a job ID:
◆ You can get the external job status of jobs submitted by other users, but you
cannot set job status of jobs submitted by other users.
◆ You can only set external status on your own jobs.
◆ Only root and LSF administrators can set external job status on jobs submitted
by other users.
Job names are not unique; if you specify
-J job_name:
◆ You can only get or set the external status on your own jobs.
◆ You cannot get or set external job status on jobs submitted by other users.
◆ Root and the LSF administrators can only get or set the external status on their
own jobs.
Options
-d "description" Updates the job status with specified message description text.
job_ID | "job_ID[index]" | -J job_name
Required. Operates on the specified job.
-h Prints command usage to stderr and exits.
-V Prints LSF release version to stderr and exits.
Examples
bstatus 2500
JOBID FROM UPDATE_TIME STATUS
2500 user1 Sep 14 16:54 step 1
Displays the message description text of message index 0 of job 2500.
bstatus -d "step 2" 2500
Changes the message description text of message index 0 of job 2500 to step 2.