qstat

View job queue status and details, with filters for users, states, and output formats.

---

Options

Supported Options

Option	Requires Value	Range/Value	Purpose	Main Differences
-u	Yes	User list or * (comma-separated)	Filter jobs by user (supports wildcards).	No difference
-f	No	None	Show full-format queue info with queue summary and job list.	No difference
-j	Yes	Job ID	Show detailed status for a specific job ID.	No difference
-xml	No	None	Output in XML format.	No difference
-g	Yes	c/d/t	Group results: cluster (c), job arrays (d), or parallel tasks (t).	-g t: all tasks show the same queue; the first is MASTER, others SLAVE.
-s	Optional	State character list	Filter by job state; if omitted, show all states.	No difference
-q	Yes	Queue name	Filter by queue.	No difference
-t	No	None	Show array job tasks (same as -g d).	No difference
-r	No	None	Show job resource requests.	Soft Resources always empty; Binding fixed to "NONE".
-pri	No	None	Show job priority info.	nurg/npprior/ntckts/ppri are dummy values (0.0).
-urg	No	None	Show job urgency info.	All fields are dummy values (0.0).
-ext	No	None	Show extended job attributes.	department is dummy "defaultdep"; tickets/share are dummy values.
-ncb	No	None	Suppress binding parameters (use with -r).	No difference
-explain	Yes	State character (a/c/A/E)	Explain queue states.	No difference
-F	Optional	Resource attribute list (comma-separated)	Show queue resource attributes.	Supported: mem_total, num_proc, qname, slots.
-U	Yes	User name	Show queues accessible to the user.	Simplified implementation.
-ne	No	None	Hide empty queues.	No difference
-qs	Yes	Queue state characters	Filter queues by state.	No difference
-l	Yes	Resource expression	Filter queues/jobs by resource.	Supports arch=, num_proc=, mem_total=.

---

Output Fields

Default Output

Field	Description	Main Differences
job-ID	Job ID	No difference
prior	Job priority (0–1)	No difference
name	Job name	No difference
user	Job owner	No difference
state	Job state	No difference
submit/start at	Submit/Start time	No difference
queue	Queue@host	No difference
slots	Job slots	No difference
ja-task-ID	Array task ID	No difference

Output for -r

Shows job resource requests under each job line:

Field	Description	Main Differences
Full jobname	Full job name	No difference
Requested PE	Requested parallel environment	Extracted from comment field
Hard Resources	Hard resource requirements	Resource priority is dummy value (0.000000)
Soft Resources	Soft resource requirements	Always empty (dummy value)
Binding	Core binding info	Fixed to dummy value "NONE"

Additional Columns for -pri

Field	Description	Main Differences
nurg	Normalized urgency	Dummy value 0.0
npprior	Normalized priority	Dummy value 0.0
ntckts	Normalized tickets	Dummy value 0.0
ppri	POSIX priority	Dummy value 0

Additional Columns for -urg

Field	Description	Main Differences
nurg	Normalized urgency	Dummy value 0.0
urg	Urgency	Dummy value 0.0
rrcontr	Resource reservation contribution	Dummy value 0.0
wtcontr	Waiting time contribution	Dummy value 0.0
dlcontr	Deadline contribution	Dummy value 0.0
deadline	Job deadline	Dummy value (empty string)

Additional Columns for -ext

Field	Description	Main Differences
ntckts	Normalized tickets	Dummy value 0.0
project	Project name	No difference
department	Department	Dummy value "defaultdep"
cpu	CPU usage	Empty for running jobs
mem	Memory usage	Empty for running jobs
io	IO usage	Empty for running jobs
tckts	Total tickets	Dummy value 0
ovrts	Override tickets	Dummy value 0
otckt	Other tickets	Dummy value 0
ftckt	Functional tickets	Dummy value 0
stckt	Share tree tickets	Dummy value 0
share	Share tree value	Dummy value 0.00

Output for -f

Shows full queue information with queue summary and job list:

Field	Description	Main Differences
queuename	Queue name	No difference
qtype	Queue type	Dummy value "BIP"
resv/used/tot	Reserved/Used/Total slots	resv is dummy value 0
load_avg	Average load	No difference
arch	Architecture	No difference
states	Queue state	No difference

Output for -g c

Field	Description	Main Differences
CLUSTER QUEUE	Cluster queue name	No difference
CQLOAD	Queue average load	No difference
USED	Used slots	No difference
RES	Reserved slots	Dummy value 0
AVAIL	Available slots	No difference
TOTAL	Total slots	No difference
aoACDS	Queue instance state summary	No difference
cdsuE	Queue state details	No difference

Output for -j

Shows job details, including:

Basic info: Job Number, Job Name, Owner, State, Submission Time, Start Time, Queue, Slots

Resource info (running/completed jobs only): Requested Resources, Granted Resources

Other info:

• Parallel Environment - extracted from comment, or "NONE"
• Project - from wckey
• Department - dummy value "defaultdep"

Output for -g t

Shows parallel task info:

Field	Description	Main Differences
master	MASTER/SLAVE indicator	All tasks show the same queue; first is MASTER, others are SLAVE

---

Examples

Example 1: Show detailed info for specific users

qstat -u userA,userB -f

• Effect: Shows full-format job info for users userA and userB.

Example 2: Filter running jobs

qstat -s r

• Effect: Lists only jobs in running state.

Example 3: XML output for a specific job

qstat -j 12345 -xml

• Effect: Displays job 12345 details in XML.

Example 4: Group array tasks and filter hold states

qstat -g d -s huo

• Effect: Groups by array jobs and filters jobs in user/admin hold states.

Example 5: Show job resource requests

qstat -r

• Effect: Shows full job name, PE, and resource requests (Hard Resources, Soft Resources, Binding).

Example 6: Show extended job attributes

qstat -ext

• Effect: Shows project, department, CPU/memory/IO usage, and ticket info.

Example 7: Show cluster queue summary

qstat -g c

• Effect: Shows queue summary including load, slot usage, and status.

Example 8: Filter by queue and show resource attributes

qstat -F -q compute

• Effect: Shows resource attributes (memory, CPU count, slots) for the specified queue.