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.

The job name can be up to 4094 characters long for UNIX and Linux or up to 255 characters for Windows. Job names are not unique.

The wildcard character (*) can be used anywhere within a job name, but cannot appear within array indices. For example job* returns jobA and jobarray[1], *AAA*[1] returns the first element in all job arrays with names containing AAA, however job1[*] will 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.

See also

bpost(1), bread(1)