Platform LSF Reference Version 6.2

bstatus
Platform LSF Reference
146
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