Job Accounting Utilities

Article ID: 172
Last updated: 14 Sep, 2026

You can use the following job accounting utilities to obtain resource usage and charging information for your project group IDs (GIDs):

  • Year-to-date summary: acct_ytd
  • Detailed account queries: acct_query
TIP: Use the myNAS portal to easily check allocation and usage for your GIDs, as well as monitor your PBS jobs. See Using the myNAS Portal for more information.

See acct_ytd -h or acct_ytd --help for more information.

The acct_ytd command

The acct_ytd command provides a year-to-date summary of accounting information for the GID groups you belong to, as of the most recent accounting run. Accounts are typically run every night at 12:00 a.m. (Pacific Time).

To view information for each GID you have access to, run the acct_ytd command on any NAS front-end node without any parameters. For example:

% acct_ytd

To view information about a single GID (for example, a0800), specify the GID on the command line:

% acct_ytd a0800

Use the -c hecc-all or -c gpu-all option to get allocation and usage information on the NAS CPU systems or the NAS GPU systems, respectively.

For example:

% acct_ytd -c hecc-all a0800
% acct_ytd -c gpu-all a0800

See acct_ytd -h or acct_ytd --help for more information.

See man acct_ytd for more information.

The acct_query command

The acct_query command searches and displays process-level billing records. You can view detailed billing records for each process run during a particular period, total processes run during the period, or total processes for each day in the period.

For example, to view all of your standard billing unit (SBU) usage for the operational year 2024 (defined as October 1, 2023 to Sept. 30, 2024) for all GIDs you have access to:

% acct_query -y24

To view all SBU usage  beginning November 1, 2024 and ending December 1, 2024 for all projects user zsmith has access to (-p all, default) and on all hosts:

% acct_query -b11/01/24 -e12/01/24 -p all -u zsmith

To specify a GID (for example, a0800), replace -p all with -p a0800.

To specify a specific host, use the -c option with a hostname.

Eligible Hostnames for the -c Option

You can use any of the following parameters after the -c option in the acct_query command line:

Note: The parameters are case sensitive.

  • Athena (for all Athena nodes)
  • Aitken (for all Aitken nodes)
  • Cabeus (for all Cabeus nodes)
  • Electra (for all Electra nodes)
  • Endeavour (for all Endeavour nodes)
  • Pleiades (for all Pleiades nodes)
  • athena_T (for Athena Turin nodes)
  • aitken_C (for Aitken Cascade Lake nodes)
  • aitken_M (for Aitken Milan nodes)
  • aitken_R (for Aitken Rome nodes)
  • cabeus_C (for Cabeus Cascade Lake + V100 node usage prior to Aug. 2026)
  • cabeus_GH (for Cabeus Grace Hopper nodes)
  • cabeus_MA (for Cabeus Milan + A100 nodes)
  • cabeus_R (for Cabeus Rome + A100 nodes usage prior to Aug. 2026)
  • cabeus_S (for Cabeus Skylake + V100 node usage prior to Aug. 2026)
  • electra_B (for Electra Broadwell nodes)
  • electra_S (for Electra Skylake nodes)
  • endeavour1 (for Endeavour node usage prior to March 31, 2021)
  • endeavour2 (for Endeavour node usage prior to March 31, 2021)
  • endeavour3
  • endeavour4
  • e-multi (for jobs that ran across Endeavour1 and Endeavour2)
  • pleiades (for Harpertown node usage prior to Aug. 2013)
  • pleiades_N (for Nehalem node usage prior to Aug. 2014)
  • pleiades_W (for Pleiades Westmere usage prior to June 2016)
  • pleiades_S (for Sandy Bridge nodes)
  • pleiades_I (for Ivy Bridge nodes)
  • pleiades_H (for Haswell nodes)
  • pleiades_B (for Pleiades Broadwell nodes)
  • pleiades_MH(for Merope Harpertown usage prior to Aug. 2014)

See acct_query -h or account_query --help for more information.

TIP: A space between the option and argument is not required in the acct_ytd or acct_query command lines. For example, acceptable syntax includes both -p all and -pall.

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.