QSTAT(1)

🌸 NAME 🌸

okay so bestie, meet qstat — aka QSTAT(1), from the User Contributed Perl Documentation corner 💖. This is the command that displays job/partition information in a familiar pbs format. Literally your main character for “what are my jobs doing” energy. Periodt. 👑

✨ SYNOPSIS ✨

the whole vibe-check menu is right here, no cap:

qstat [-f] [-a|-i|-r] [-n [-1]] [-G|-M] [-u user_list] [-? | --help]
      [--man] [job_id...]

      qstat -Q [-f]

      qstat -q

💅 DESCRIPTION 💅

qstat displays information about jobs. That’s it, that’s the tweet — but like, it’s a very useful tweet, bestie. 🫶

🎀 OPTIONS 🎀

• -a — displays all jobs in a single-line format. The STANDARD OUTPUT section has the format details, iykyk. ✨
• -i — displays information about idle jobs. This includes jobs which are queued or held. 💤
• -f — displays the full information for each selected job in a multi-line format. STANDARD OUTPUT has the tea. 🍵
• -G — display size information in gigabytes. 💾
• -M — show size information, disk or memory, in mega-words. A word is considered to be 8 bytes. 🔥
• -n — displays nodes allocated to a job in addition to the basic information. 🧚
• -1 — in combination with -n, puts all of the nodes on the same line as the job id. 🎀
• -r — displays information about running jobs. This includes jobs which are running or suspended. 🏃‍♀️
• -u user_list — display job information for all jobs owned by the specified user(s). The format of user_list is: user_name[,user_name...]. 👯‍♀️
• -? | --help — brief help message. 🙋‍♀️
• --man — full documentation. 📖

🌈 STANDARD OUTPUT 🌈

✨ Displaying Job Status ✨

If you don’t specify -a, -i, -f, -r, -u, -n, -G, and -M, you get the brief single-line display format. The following items are displayed on a single line, in this exact order, separated by white space:

• the job id
• the job name
• the job owner
• the cpu time used
• the job state
  • C — Job is completed after having run
  • E — Job is exiting after having run.
  • H — Job is held.
  • Q — job is queued, eligible to run or routed.
  • R — job is running.
  • T — job is being moved to new location.
  • W — job is waiting for its execution time (-a option) to be reached.
  • S — job is suspended.
• the queue that the job is in

If -f is specified, the multi-line display format is used. The output for each job consists of the header line Job Id: job identifier, followed by one line per job attribute of the form attribute_name = value. 🦋

If any of the options -a, -i, -r, -u, -n, -G or -M are specified, the normal single-line display format is used. The following items are displayed on a single line, in the specified order, separated by white space:

• the job id
• the job owner
• the queue the job is in
• the job name
• the session id (if the job is running)
• the number of nodes requested by the job
• the number of cpus or tasks requested by the job
• the amount of memory requested by the job
• either the cpu time, if specified, or wall time requested by the job, (in hh:mm)
• the job state
• the amount of cpu time or wall time used by the job (in hh:mm)

💀 EXIT STATUS 💀

On success, qstat will exit with a value of zero. On failure, qstat will exit with a value greater than zero. That’s the whole pass/fail vibe check, bestie. ✅💀

---

okay bye bestie 💅✨ this iconic page is QSTAT(1), from perl v5.40.2, dated 2026-10-14. slay and stay hydrated out there 🫶🎀