Description:
squeue is used to view job and job step information for jobs managed by Slurm.
Options:
-h, --noheader
Do not print a header on the output.
-l, --long
Report more of the available information for the selected jobs or job steps, subject to any constraints specified.
--help
Print a help message describing all options squeue.
--usage
Print a brief help message listing the squeue options.
-u <user_name>, --user=<user_name>
Request a comma separated list of users to view. Defaults to all users.
-j <job_id_list>, --jobs=<job_id_list>
Requests a comma separated list of job IDs to display. Defaults to all jobs.
-n <name_list>, --name=<name_list>
Request jobs or job steps having one of the specified names. The list consists of a comma separated list of job names.
-p <part_list>, --partition=<part_list>
Specify the partitions of the jobs or steps to view. Accepts a comma separated list of partition names.
-w <hostlist>, --nodelist=<hostlist>
Report only on jobs allocated to the specified node or list of nodes.
-q <qos_list>, --qos=<qos_list>
Specify the qos(s) of the jobs or steps to view. Accepts a comma separated list of qos's.
-t <state_list>, --states=<state_list>
Specify the states of jobs to view.
Accepts a comma separated list of state names or "all". If "all" is specified then jobs of all states will be reported. If no state is specified then pending, running, and completing jobs are reported.
Valid states (in both extended and compact form) include: PENDING (PD), RUNNING (R), SUSPENDED (S), STOPPED (ST), COMPLETING (CG), COMPLETED (CD), CONFIGURING (CF), CANCELLED (CA), FAILED (F), TIMEOUT (TO), PREEMPTED (PR), BOOT_FAIL (BF) , NODE_FAIL (NF) and SPECIAL_EXIT (SE).
-A <account_list>, --account=<account_list>
Specify the accounts of the jobs to view. Accepts a comma separated list of account names. This has no effect when listing job steps.
-L <license_list>,--licenses=<license_list>
Request jobs requesting or using one or more of the named licenses. The license list consists of a comma separated list of license names.
-r, --array
Display one job array element per line. Without this option, the display will be optimized for use with job arrays (pending job array elements will be combined on one line of output with the array index values printed using a regular expression).
-O <output_format>, --Format=<output_format>
Specify the information to be displayed.
Also see the -o <output_format>, --format=<output_format> option described below (which supports greater flexibility in formatting, but does not support access to all fields because we ran out of letters).
The format of each field is "%[[.]size]type".
size
Is the minimum field size. If no size is specified, whatever is needed to print the information will be used.
.
Indicates the output should be right justified and size must be specified. By default, output is left justified.
For example, the default squeue output equals to squeue "%.18i %.9P %.8j %.8u %.2t %.10M %.6D %R".
| -o, --format | -O, --Format | Description |
|---|---|---|
| %all | Print all fields available for this data type with a vertical bar separating each field. | |
| %a | account | Account associated with the job. (Valid for jobs only) |
| %A | Job id. This will have a unique value for each element of job arrays. (Valid for jobs only) | |
| %b | gres | Generic resources (gres) required by the job or step. (Valid for jobs and job steps) |
| %C | numcpus | Number of CPUs (processors) requested by the job or allocated to it if already running. As a job is completing this number will reflect the current number of CPUs allocated. (Valid for jobs only) |
| %D | numnodes | Number of nodes allocated to the job or the minimum number of nodes required by a pending job. |
| %e | endtime | Time at which the job ended or is expected to end (based upon its time limit). (Valid for jobs only) |
| %F | jobarrayid | Job array's job ID. This is the base job ID. For non-array jobs, this is the job ID. (Valid for jobs only) |
| %i | jobid | Job or job step id. In the case of job arrays, the job ID format will be of the form "<base_job_id>_<index>" |
| %j | name | Job or job step name. (Valid for jobs and job steps) |
| %k | comment | Comment associated with the job. (Valid for jobs only) |
| %l | mintime | Time limit of the job or job step in days-hours:minutes:seconds. |
| %m | minmemory | Minimum size of memory (in MB) requested by the job. (Valid for jobs only) |
| %M | timeused | Time used by the job or job step in days-hours:minutes:seconds. The days and hours are printed only as needed. |
| %N | List of nodes allocated to the job or job step. (Valid for jobs and job steps) | |
| nodes | In the case of a COMPLETING job, the list of nodes will comprise only those nodes that have not yet been returned to service. (Valid job steps only) | |
| nodelist | In the case of a COMPLETING job, the list of nodes will comprise only those nodes that have not yet been returned to service. (Valid job only) | |
| %o | command | The command to be executed. |
| %p | priority | Priority of the job (converted to a floating point number between 0.0 and 1.0). (Valid for jobs only) |
| %P | partition | Partition of the job or job step. (Valid for jobs and job steps) |
| %q | qos | Quality of service associated with the job. (Valid for jobs only) |
| %r | reason | The reason a job is in its current state. See the JOB REASON CODES section below for more information. (Valid for jobs only) |
| %R | reasonlist | For pending jobs: the reason a job is waiting for execution is printed within parenthesis. For terminated jobs with failure: an explanation as to why the job failed is printed within parenthesis. For all other job states: the list of allocate nodes. See the JOB REASON CODES section below for more information. (Valid for jobs only) |
| %S | starttime | Actual or expected start time of the job or job step. (Valid for jobs and job steps) |
| %t | statecompact | Job state, compact form: PD (pending), R (running), CA (cancelled), CF(configuring), CG (completing), CD (completed), F (failed), TO (timeout), NF (node failure) and SE (special exit state). See the JOB STATE CODES section below for more information. (Valid for jobs only) |
| %T | state | Job state, extended form: PENDING, RUNNING, SUSPENDED, CANCELLED, COMPLETING, COMPLETED, CONFIGURING, FAILED, TIMEOUT, PREEMPTED, NODE_FAIL and SPECIAL_EXIT. See the JOB STATE CODES section below for more information. (Valid for jobs only) |
| %u | username | User name for a job or job step. (Valid for jobs and job steps) |
| %v | reservation | Reservation for the job. (Valid for jobs only) |
| %V | submittime | The job's submission time. |
| %W | licenses | Licenses reserved for the job. (Valid for jobs only) |
| %y | nice | Nice value (adjustment to a job's scheduling priority). (Valid for jobs only) |
| %z | sct | Number of requested sockets, cores, and threads (S:C:T) per node for the job. When (S:C:T) has not been set, "*" is displayed. (Valid for jobs only) |
| %Z | workdir | The job's working directory. |