bstatus
Gets current external job status or sets new job status.
Synopsis
bstatus [-d "description"] job_ID | "job_ID[index]" | -J job_nameDescription
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.
- You can get the external job status of jobs submitted by other users, but you cannot set job status of jobs that are submitted by other users.
- You can set external status only on your own jobs.
- Only root and LSF administrators can set external job status on jobs that are submitted by other users.
- You can get or set the external status only on your own jobs.
- You cannot get or set external job status on jobs that are submitted by other users.
- Root and the LSF administrators can get or set the external status only 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.
The job name can be up to 4094 characters long. Job names are not unique.
The wildcard character (*) can be used anywhere within a job name, but it cannot appear within an array index. For example, the pattern job* returns jobA and jobarray[1]. The *AAA*[1] pattern returns the first element in job arrays with names that contain AAA. However, the pattern job1[*] does not return anything since the wildcard is within the array index.
- -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.