QSTATUS(1)

✨ QSTATUS(1) ✨

okay so bestie, welcome to qstatus(1) — it lives in the User Commands section of the manual, and honestly? it's a little glow-up machine for your Grid Engine life. let's get into it 💅

---

🌸 NAME 🌸

qstatus — the Grid Engine qstatus script. that's it, that's the name, she's simple and she's iconic 💖

---

🦋 SYNOPSIS 🦋

qstatus [-acghjlmnot] [-s SORT_FIELD_LIST] [USER]

---

✨ DESCRIPTION ✨

so this manual page is documenting qstatus, which is a script whose whole personality is reformatting the output of the Grid Engine command qstat(1). she takes what qstat gives you and makes it cute and readable, no cap.

by default, the reformatted list is limited to your actual user account — like, it only shows your stuff, because main character energy starts with yourself 🫶

but you can change that, two ways:

• pass a username as USER, the last argument, and boom — you get that user's job list
• or hit the -a switch (peep below) and get output for all users

💅 Options 💅

• -a — shows the jobs of all users. you may NOT use this when there's a dedicated user specified, okay? pick a lane. also this implies the output of the owner of the jobs.
• -c — calculates a statistic of the listed jobs. numbers girlies rise up 📊
• -g — groups the output by owner. only applies if the owner is actually listed — either because of the -o switch or because -a implied it. this is basically a short form of -s owner,running. and it can't be used together with the -s option. choose your fighter.
• -h — prints help. the classic cry for assistance 🥺
• -j — includes jobs that are suspended. let the sleepy ones in.
• -l — suppresses the output of the list of jobs. lowkey useful if all you care about is the statistic from the -c switch. just the numbers, ma'am.
• -m — displays the machine instead of the name of the queue the job is running in, under the column running in. only meaningful for SGE 6.0 or above, so if you're on something ancient, this is giving nothing.
• -n — suppresses the listing of the individual owner. mostly useful when all jobs are being listed. this takes precedence over any other implied options. and if you use it together with -o, only the later one is relevant. (yes, order matters. the last one wins. periodt.)
• -o — lists the owner of the individual job. this takes precedence over any other implied option. if you use it together with -n, only the later one is relevant. same deal, last one standing wins 👑
• -r — displays times relative to submit- or start-times, as appropriate. vibes in relative time, love that.
• -s SORT_FIELD_LIST — sorts the output according to the given columns. the SORT_FIELD_LIST has the format:

SORT_FIELD_LIST=SORT_FIELD[,SORT_FIELD]*

where SORT_FIELD can be one of job, name, none, owner, running, slots, time.

deets on the sort fields, bestie:

• the option none will supersede any other column names and set the complete sort order to none. she's not like the other girls, she overrides everyone.
• the column owner can only be used if the owner of the job is displayed at all. otherwise it will be ignored. respect the prerequisites.
• the sort by running will only be used for the running jobs, not for the waiting ones.

this will overwrite the default sort order, which is:

running jobs:  running
waiting jobs:  none

and if the option -g is specified, the default sort order changes to:

running jobs:  owner,running
waiting jobs:  owner

• -t — appends the task ID to the jobname for array tasks. this option has no meaning for non-array jobs, so don't come for her if nothing happens.

---

🌈 AUTHOR 🌈

Written by Reuti. 💖

---

🎀 REPORTING BUGS 🎀

Report bugs to <reuti@staff.uni-marburg.de>. she wants to hear from you, fr fr 🫶

---

⭐ COPYRIGHT ⭐

Copyright © 2010 Philipps-University of Marburg.

This is free software. You may redistribute copies of it under the terms of the GNU General Public License http://www.gnu.org/licenses/gpl.html.

There is NO WARRANTY, to the extent permitted by law. like, zero. none. nada. 🙈

---

👑 SEE ALSO 👑

qstat(1) of Grid Engine. go read her too, they're besties 💜

---

💀 BUGS 💀

• Does not support the PBS or Torque resource manager. sorry PBS girlies, she said no.
• The Awk script used probably isn't portable and may require GNU Awk version 3 or higher. so if it's acting up, check your awk, bestie, that's the vibe check 😭

---

and that's the whole page! this was qstatus version 1.6, dated 30 NOVEMBER 2010 — an oldie but a goodie, still serving looks. mwah 💋✨