[ Platform Documentation ]

[ Title ]

[ Contents ]

[ Previous ]

[ Next ]

[ Index ]

---

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.

SEE ALSO

bpost(1), bread(1)

[ Top ]

---

[ Platform Documentation ]

[ Title ]

[ Contents ]

[ Previous ]

[ Next ]

[ Index ]

---

Date Modified: February 24, 2004 Platform Computing: www.platform.com Platform Support: support@platform.com Platform Information Development: doc@platform.com Copyright © 1994-2004 Platform Computing Corporation. All rights reserved.