QHIST(1)

NAME
qhist - a utility for querying historical PBS records

SYNOPSIS
qhist [-h] [-A ACCOUNT] [-a] [-c] [-d DAYS] [-e EVENTS] [-F FILTER] [-f FORMAT] [-H [HOST ...]] [-J] [-j [JOBID ...]] [-l] [-N JOBNAME] [-n] [--noheader] [-p PERIOD] [-q QUEUE] [-r] [-s EXIT_STATUS] [-t {s,m,h,d}] [-U] [-u USER] [-W WAIT] [-w]

DESCRIPTION
This command allows you to query the PBS accounting records for finished jobs. Any job that has an end-type record (E,R) can be queried. If a job has not yet completed, it will not appear here and users should consult "qstat" instead. By default, qhist will only show jobs from the current calendar day, but this can be customized. Many options are available for filtering data. Most of them support negation by prepending the search value by the "~" character (such values should be encapsulated in quotation marks to avoid shell substitutions).

OPTIONS

-A ACCOUNT, --account ACCOUNT
    filter jobs by a specific account/project code

-a, --average
    print average resource statistics in default/wide mode

-c, --csv
    output jobs in csv format

-d DAYS, --days DAYS
    number of days prior to search (default = 0)

-e EVENTS, --events EVENTS
    list of events to display (E=end, R=requeue)

-F FILTER, --filter FILTER
    specify a freeform filter (--filter=help for more)

-f FORMAT, --format FORMAT
    use custom format (--format=help for more)

-H [HOST ...], --hosts [HOST ...]
    only print jobs that ran on specified comma-delimited list of nodes

-J, --json
    output jobs in json format

-j [JOBID ...], --jobs [JOBID ...]
    one or more job IDs

-l, --list
    display untruncated output in list format

-N JOBNAME, --name JOBNAME
    only print jobs that have the specified job name

-n, --nodes
    show list of nodes for each job

--noheader
    do not display a header for tabular output

-p PERIOD, --period PERIOD
    specify time range (YYYYmmdd-YYYYmmdd or YYYYmmdd for a single day)

-q QUEUE, --queue QUEUE
    filter jobs by a specific queue

-r, --reverse
    print jobs in reverse order

-s EXIT_STATUS, --status EXIT_STATUS
    only print jobs with specified exit status

-t {s,m,h,d}, --time {s,m,h,d}
    display time deltas in seconds, minutes, or hours (default)

-U, --units
    add units to tabular or csv headers

-u USER, --user USER
    filter jobs by a specific user

-W WAIT, --wait WAIT
    show jobs with queue waits above value in minutes

-w, --wide
    use wide table columns and show job names

AUTHOR
Written by Brian Vanderwende.