Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Queue and Accounting

squeue

squeue shows top-level queued and running jobs.

Common Options

OptionMeaning
--allShow all states
-t, --statesFilter by state
-j, --jobsFilter by job IDs
-u, --userFilter by user
-p, --partitionFilter by partition
-o, --formatSelect output fields
-S, --sortSort rows
-l, --longLong default view
--startShow estimated start times
--arrayShow array-style job IDs
--noheaderOmit the header

Default View

JOBID | PARTITION | NAME | USER | ST | TIME | NODELIST(REASON)

Long View

JOBID | PARTITION | NAME | USER | ST | TIME | TIME_LIMIT | NTASKS | CPUS | REQ_MEM | REQ_GPU | NODELIST(REASON)

Start-Time View

With --start and no explicit format:

JOBID | PARTITION | NAME | USER | ST | START_TIME | NODELIST(REASON)

Format Fields

Supported field names:

  • JobID
  • Partition
  • Name, JobName
  • User
  • ST, State
  • Time, Elapsed
  • TimeLimit, Time_Limit
  • NTasks
  • CPUS, ReqCPUS
  • ReqMem
  • ReqGPU, ReqGPUS
  • Start, StartTime
  • NodeList(Reason), NodeListReason, Reason, NodeList

Supported % codes:

  • %i
  • %P
  • %j
  • %u
  • %t, %T
  • %M
  • %S
  • %R, %N

sacct

sacct shows persisted accounting data, including completed jobs and steps.

Common Options

OptionMeaning
-j, --jobsFilter by job IDs
-s, --stateFilter by state
-S, --starttimeFilter by start time
-E, --endtimeFilter by end time
-u, --userFilter by user
-p, --partitionFilter by partition
-o, --formatSelect output fields
-P, --parsable2Use `
-n, --noheaderOmit the header

Default View

JobID | Partition | JobName | User | State | ExitCode

Record Types

sacct includes:

  • top-level jobs
  • allocation records
  • step records
  • completed records

ID rendering rules:

  • step IDs appear as <job_id>.<step_id>
  • array tasks appear as <array_job_id>_<task_id>

Format Fields

Supported field names:

  • JobID
  • ArrayJobID
  • ArrayTaskID
  • JobName
  • Partition
  • User
  • State
  • Reason
  • ExitCode
  • Elapsed
  • AllocCPUS
  • ReqMem
  • ReqTRES
  • AllocTRES
  • NodeList
  • Submit
  • Start
  • End
  • WorkDir
  • BatchFlag
  • MaxRSS

Supported % codes:

  • %i
  • %F
  • %K
  • %j
  • %P
  • %u
  • %t, %T
  • %R
  • %X
  • %M
  • %C
  • %m
  • %b
  • %B
  • %N
  • %V
  • %S
  • %E
  • %Z