bpeek

info

This command is supported starting from fsched-TBD.

Overview

bpeek displays the standard output of unfinished batch jobs. It lets users monitor job execution in real time, similar to viewing a log file.

Parameters

Option	Description	Key Differences
-f	Follow output continuously (like tail -f) until the job completes.	No difference.
-q	Show the most recently submitted job in the specified queue.	No difference.
-m	Show the most recently submitted job on the specified host.	No difference.
-J	Show the most recently submitted job with the specified name (supports wildcard *).	No difference.
-V	Print version and exit.	No difference.

job_id Parameters

Format	Description	Key Differences
None (default)	Show the most recently submitted job for the current user.	No difference.
job_ID	Show the job with the specified id.	No difference.
job_ID[index_list]	Show the job array with the specified id and index_list.	When -J matches multiple array tasks, you must specify the index explicitly.

Mutually Exclusive Options

-q, -m, -J, and the job_ID parameter are mutually exclusive. Use only one at a time.

Examples

1. View output for a specific job

   bpeek 10023

2. Follow job output continuously

   bpeek -f 10023

3. View the most recent job output in a queue

   bpeek -q normal

4. View the most recent job output on a host

   bpeek -m node01

5. View the most recent job output by name

   bpeek -J my_simulation

6. View output for a specific task in a job array

   bpeek "10023[5]"

Notes

• Only batch jobs are supported; interactive jobs are not supported.
• The job must have started (not in pending state), otherwise it reports "Job <job_id> has not been dispatched yet".
• The job cannot be completed (completed/failed/cancelled/timeout), otherwise it reports "Job <job_id> already finished".
• With -f, the command keeps streaming output until the job completes or the user interrupts (Ctrl+C).
• When using -J and multiple tasks in the same array match, you must specify the task index explicitly, for example bpeek "job_id[index]".