bpeek

Displays the stdout and stderr output of an unfinished job.

Synopsis

bpeek [-f] [-q queue_name | -m host_name | -J job_name | job_ID | "job_ID[index_list]"]
bpeek [-h | -V]

Description

Displays the standard output and standard error output that is produced by one of your unfinished jobs, up to the time that you run the command.

By default, displays the output by using the command cat.

This command is useful for monitoring the progress of a job and identifying errors. If errors are observed, valuable user time and system resources can be saved by stopping an erroneous job.

Options

-f
Displays the output of the job by using the command tail -f. When the job is completed, the bpeek -f command exits.

If the peeked job is requeued or migrated, abort any previous bpeek -f command and rerun the bpeek -f command.

-q queue_name
Operates on your most recently submitted job in the specified queue.
-m host_name
Operates on your most recently submitted job that was dispatched to the specified host.
-J job_name
Operates on your most recently submitted job that has the specified job name.

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.

job_ID | "job_ID[index_list]"
Operates on the specified job.
-h
Prints command usage to stderr and exits.
-V
Prints LSF release version to stderr and exits.

See also

cat, tail, bsub, bjobs, bhist, bhosts, bqueues