bstatus

gets current external job status or sets new job status

Synopsis

bstatus [-d "description"] job_ID "job_ID[index]" -Jjob_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 -doption. 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 -Jjob_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]" -Jjob_name

Required. Operates on the specified job.

-hPrints command usage to stderr and exits.

-VPrints 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.

Platform LSF Command Reference 173