bhist

info

This command is supported starting from fsched-10.87.

Overview

bhist displays job history information.

Option	Description	Key Differences
`-a`	Show completed and unfinished job information	No difference
`-b`	Brief format	No difference
`-C`	Show jobs completed/exited within the specified time interval	No difference
`-d`	Show completed job information	No difference
`-D`	Show jobs dispatched within the specified time interval	No difference
`-e`	Show exited job information	No difference
`-h`	Print help information	Provides more detailed help information
`-J`	Show jobs with the specified job name	No difference
`-Jd`	Filter by job description	No difference
`-l`	Long format with detailed job information	Details listed in later sections
`-m`	Show jobs dispatched to the specified host	No difference
`-p`	Show pending job information	No difference
`-P`	Show jobs belonging to the specified project	No difference, `project` maps to `wckey`
`-q`	Show jobs submitted to the specified queue	No difference
`-r`	Show running job information	No difference
`-s`	Show suspended job information	No difference
`-S`	Show jobs submitted within the specified time interval	No difference
`-u`	Show jobs submitted by the specified user	No difference
`-V`	Print version information	No difference
`-w`	Wide format	No difference

Field	Description	Key Differences
`Time Summary`	Summary of time spent in different job states
- `PEND`	Total wait time for the job (excluding user suspend time)	No difference
- `PSUSP`	Total user suspend time while pending	Pending job suspension not supported
- `RUN`	Total run time for the job	No difference
- `USUSP`	Total user suspend time after dispatch	Shows suspend time without distinguishing user vs system suspend
- `SSUSP`	Total system suspend time after dispatch	Dummy value is 0
- `UNKWN`	Total time in unknown state	Dummy value is 0
- `TOTAL`	Total time across all states	Shows `PEND+RUN+USUSP`

Field	Description	Key Differences
`Project`	Project of the submitted job	No difference, `project` maps to `wckey`
`Command`	Job command	`Command` is unavailable after the job has been completed for some time
`Requested Resources`	Full resource requirement string from `bsub`	Only `rusage[mem=xxx]` is shown
`Execution CWD`	Actual working directory during job execution	No difference
`Effective RES_REQ`	Effective resource requirements after scheduler parsing or construction	`select` and `order` are dummy values; `rusage` shows the `mem` value
`Terminated jobs`	Exit reason for terminated jobs	Exit reason is a dummy value
`Interactive jobs`	Special information for interactive jobs	Output also includes `CWD`, `home`
`Dispatched Tasks`	Allocated task count and hosts	No difference
`Allocated Slots`	Allocated slot count and hosts when `LSB_ENABLE_HPC_ALLOCATION=Y`	No difference
`Pid`	Job process ID	`Pid` is unavailable after the job has been completed for some time
`Suspend event time`	Time when the job was suspended	Suspend time is not available; estimated as a single suspend event
`Memory usage information`	Peak and average memory usage	No difference
`Submit host`	Submission host	`Submit host` is unavailable after the job has been completed for some time
`Queue`	Queue name	No difference
`Job Description`	Job description	No difference

Filter	Description	Key Differences
None (default)	Show all historical jobs	To avoid database pressure from too many jobs, the default query is limited to the past week. You can set the range via `-C`. `-D` and `-S` still query the past week and filter within the results.
job_ID...	Restore one or more jobs with the specified `id`.	No difference
job_ID[index_list]...	Restore one or more jobs with the specified `id` and `index_list`.	No difference

To avoid database pressure from too many jobs, the wrapper limits the default query to the past week. You can set the range via -C.
If there are many jobs in the query range, database pressure is still possible.