Monitor your allocation with xdusage

The xdusage command-line tool reports the status of all your XSEDE allocations. xdusage displays your total SU award, SUs used and SUs remaining for each of your allocations. Note that you only have visibility into your own and your project coworkers' status.

If the xdusage command is not already in your environment (determined using the which xdusage command), load the module using the module load xdusage command.

login1$ xdusage
Project: TG-ASC150024/comet-gpu.sdsc.xsede
PI: Smith, Veronica
Allocation: 2018-04-01/2019-03-31
Total=2,500 Remaining=2,272 Usage=228 Jobs=72
    Smith, Veronica portal=vsmith usage=0 jobs=0

Project: TG-ASC150024/oasis.sdsc.xsede
PI: Smith, Veronica
Allocation: 2018-04-01/2019-03-31
Total=500 Remaining=500 Usage=0 Jobs=0
    Smith, Veronica portal=vsmith usage=0 jobs=0

Project: TG-ASC150027/comet-gpu.sdsc.xsede
PI: Smith, Robert J.
Allocation: 2017-04-05/2018-10-04
Total=2,500 Remaining=2,219 Usage=281 Jobs=133
    Smith, Veronica portal=vsmith usage=0 jobs=0

Project: TG-ASC150027/comet.sdsc.xsede
PI: Smith, Veronica
PI: Norman, Michael L.
Allocation: 2017-04-05/2018-10-04
Total=65,000 Remaining=22,194 Usage=42,806 Jobs=2005
    Smith, Veronica portal=vsmith usage=2 jobs=1

Project: TG-STA160003/bridges-large.psc.xsede
PI: Smith, Veronica
Allocation: 2017-08-04/2018-08-03
Total=1,000 Remaining=1,000 Usage=0 Jobs=0
    Smith, Veronica portal=vsmith usage=0 jobs=0

Project: TG-STA160003/bridges.psc.xsede
PI: Smith, Veronica
Allocation: 2017-08-04/2018-08-03
Total=50,000 Remaining=50,000 Usage=0 Jobs=0
    Smith, Veronica portal=vsmith usage=0 jobs=0

Project: TG-STA160003/bridges-pylon.psc.xsede
PI: Smith, Veronica
Allocation: 2017-08-04/2018-08-03
Total=500 Remaining=500 Usage=0 Jobs=0
    Smith, Veronica portal=vsmith usage=0 jobs=0

Project: TG-STA160003/comet-gpu.sdsc.xsede
PI: Smith, Veronica
Allocation: 2017-08-04/2018-08-03
Total=2,500 Remaining=2,490 Usage=10 Jobs=10
    Smith, Veronica portal=vsmith usage=0 jobs=0

Project: TG-STA160003/maverick.tacc.xsede status=inactive
PI: Smith, Veronica
Allocation: 2017-08-04/2018-08-03
Total=3,000 Remaining=3,000 Usage=0 Jobs=0
    Smith, Veronica portal=vsmith status=inactive usage=0 jobs=0

In the above example, user Veronica Smith has both active and inactive allocations on several different XSEDE resources under multiple PIs. You may query your allocation status on four criteria. Examples below show syntax and a sample command:

  • by project

    xdusage -p projectnumber
    login1$ xdusage -p TG-STA060001N

  • by user with XSEDE User Portal username

    xdusage -up xupusername
    login1$ xdusage -u vsmith

  • by resource
    xdusage -r resource
    login1$ xdusage -r stampede2
  • by time period
    xdusage -s startdate -e enddate
      login1$ xdusage -s 7/1/2014 -e 12/31/2014
      login1$ xdusage -s 7/2014 -e 12/2014
  • or with a combination of available options
    login1$ xdusage -s stampede2 -ip

Common xdusage options are detailed in Table 1 below. Consult the full xdusage man page or by issuing the standard "man" command:

login1$ man xdusage

Table 1. Common xdusage options

Option Description
-p project specify XSEDE project #
-r resource specify XSEDE resource e.g., bridges, comet
-u username | Last name specify user with your local resource username
-up portal-username specify user with your XSEDE User Portal username
-a show all accounts -- ignored with -u
-j show jobs, refunds, etc
-ip suppress inactive projects
-ia suppress inactive accounts
-zp suppress projects with zero usage
-za suppress accounts with zero usage
-s startdate -e enddate display usage for period between startdate and enddate
-h print help

Last modified: July 10, 2018