Using qsh.pl to Check Memory Usage

Article ID: 219
Last updated: 13 Jan, 2026

You can use the qsh.pl tool to check the memory usage of jobs running on Aitken or Electra. This tool is a Perl script that uses Secure Shell (SSH) protocol to access all of the nodes used by a PBS job in order to run a command that you supply.

For Aitken and Electra jobs, you can run qsh.pl on the PFEs.

The qsh.pl tool is available in the /u/scicon/tools/bin directory.

TIP: You can either run module load scicon/cli/tools or add the directory to your shell startup script so that you can invoke qsh.pl without typing the full path each time. For example:
set path = ( $path /u/scicon/tools/bin )

Syntax:

pfe21% qsh.pl job_id command 

You can use this script to check the amount of free memory in the nodes of your PBS job.

Example:

pfe21% qsh.pl 30329 "cat /proc/meminfo"

running "cat /proc/meminfo" on:  r56i2n14 r56i2n15
r56i2n14 :
  MemTotal:      8079728 kB
  MemFree:        857936 kB
  Buffers:             0 kB
  Cached:        3775472 kB
...
r56i2n15 :
  MemTotal:      8079728 kB
  MemFree:       5840920 kB
  Buffers:             0 kB
  Cached:         784280 kB
...

The qsh.pl script was provided by NAS staff member Bob Hood.

Contact Us

General User Assistance

Security

  • Report security issues 24x7x365
  • Toll-free: 1-877-NASA-SEC (1-877-627-2732)
  • E-mail: soc@nasa.gov

User Documentation

High-End Computing Capability (HECC) Portfolio Office

NASA High-End Computing Program

Tell Us About It

Our goal is furnish all the information you need to efficiently and effectively use the HECC resources needed for your NASA computational projects.

We welcome your input on features and topics that you would like to see included on this website.

Please send us email with your wish list and other feedback.