OSCusage

Introduction

OSCusage is command developed at OSC for use on OSC's systems.  It allows for a user to see information on their project's current RU balance, including which users and jobs incurred what charges.

Availability

Oakley ruby owens
X X X

 

Usage

OSCusage takes the following options and parameters.

usage: OSCusage [-qvn] -[r|h] [MM/DD/YYYY] [MM/DD/YYYY]
         or [-i]
Note: the year requires all 4 digits.
OSCusage can only provide information on a user's primary project, visible with the command id -gn.  If you are a part of other projects, visible under id -Gn, you will be unable to pull information on those projects.  Contact OSC Help for assistance in getting such information.

Today's Usage

Running OSCusage with no options or parameters specified will provide RU usage information per a user for the current day.

$ OSCusage

                     Usage Statistics for project PAS0435
                            for 5/3/2016 to 5/3/2016

                   PI: Dr. Judith Gardiner
                             RU Balance: -17.88635

        Username  Dates                            RUs  Status

          osu525    5/3/2016 to   5/3/2016     0.00000  ACTIVE
         *osu391    5/3/2016 to   5/3/2016     0.00000  ACTIVE
         osu6396    5/3/2016 to   5/3/2016     0.00000  ACTIVE
         osu6445    5/3/2016 to   5/3/2016     0.00000  PASSWORD
         osu8968    5/3/2016 to   5/3/2016     0.00000  ACTIVE
 ===============   PAS0435 TOTAL    0.00000

Users on Project

Specifying -i provides information on the accounts under the project.

$ OSCusage -i
                        Information for project PAS0435
                   PI: Dr. Judith Gardiner
                             RU Balance: -17.88635

            Username    Status  Full Name

             *osu391    ACTIVE  Dr. Judith Gardiner
             osu6396    ACTIVE  Dr. Judith Gardiner
             osu8968    ACTIVE  Koh Schooley

RU Usage in Timeframe

If you specify a timeframe you can get RU utilization information specifically for jobs that completed within that period.

$ OSCusage 01/01/2016 05/01/2016

                     Usage Statistics for project PAS0435
                          for 01/01/2016 to 05/01/2016

                   PI: Dr. Judith Gardiner
                             RU Balance: -17.88635

        Username  Dates                            RUs  Status

          osu525  01/01/2016 to 05/01/2016     0.00000  ACTIVE
         *osu391  01/01/2016 to 05/01/2016     0.00000  ACTIVE
         osu6396  01/01/2016 to 05/01/2016     0.00000  ACTIVE
         osu6445  01/01/2016 to 05/01/2016     0.00000  PASSWORD
         osu8968  01/01/2016 to 05/01/2016     0.15752  ACTIVE
 ===============   PAS0435 TOTAL    0.15752

Show only my usage

Specify -q to show only the current user's usage.

$ OSCusage -q 01/01/2016 05/01/2016

                     Usage Statistics for project PAS0435
                          for 01/01/2016 to 05/01/2016

                   PI: Dr. Judith Gardiner
                             RU Balance: -17.88635

        Username  Dates                            RUs  Status

         osu8968  01/01/2016 to 05/01/2016     0.15752  ACTIVE
 ===============   PAS0435 TOTAL    0.15752

Detailed Charges Breakdown

Specify -v to get detailed information on what job's incurred what charges.

$ OSCusage -v 01/01/2016 05/01/2016

                     Usage Statistics for project PAS0435
                          for 01/01/2016 to 05/01/2016

                   PI: Dr. Judith Gardiner
                             RU Balance: -17.88635

                        Start                 RUs     Charge           Status
        Username  Date  Date & Time          Used       Type     Queue           Job

 -------------            osu525 TOTAL    0.00000
 -------------           *osu391 TOTAL    0.00000
 -------------           osu6396 TOTAL    0.00000
 -------------           osu6445 TOTAL    0.00000
         osu8968 03/30  03/29 15:14:31    0.00277   CPU-Ruby    serial  E      STDIN
         osu8968 03/22  03/21 11:38:14    0.00005 CPU-Oakley    serial  E   login_en
         osu8968 03/22  03/21 11:48:25    0.00005 CPU-Oakley    serial  E   test_env
         osu8968 03/10  03/09 12:30:36    0.00066 CPU-Oakley    serial  E   test_pat
         osu8968 02/20  02/19 17:14:23    0.01266 CPU-Oakley  parallel  E   initial_
         osu8968 02/20  02/19 17:16:24    0.14133 CPU-Oakley  parallel  E   initial_
 -------------           osu8968 TOTAL    0.15752
 ===============   PAS0435 TOTAL    0.15752

View Usage in Hours

Specify -h to view the usage information in core hours, as opposed to RUs.

$ OSCusage -h 01/01/2016 05/01/2016

                     Usage Statistics for project PAS0435
                          for 01/01/2016 to 05/01/2016

                   PI: Dr. Judith Gardiner
                             RU Balance: -17.88635

                 Note: Listing is in HOURS, as opposed to RUs.

        Username  Dates                            HRS  Status

          osu525  01/01/2016 to 05/01/2016     0.00000  ACTIVE
         *osu391  01/01/2016 to 05/01/2016     0.00000  ACTIVE
         osu6396  01/01/2016 to 05/01/2016     0.00000  ACTIVE
         osu6445  01/01/2016 to 05/01/2016     0.00000  PASSWORD
         osu8968  01/01/2016 to 05/01/2016     1.57520  ACTIVE
 ===============   PAS0435 TOTAL    1.57520

Usage on Secondary Group Projects

Oct 3, 2017: This function is broken now. We are working to fix it soon. 

Specifying -A provides usage information for all of the secondary group projects authorized under your account, including the primary project. This is mainly for Annual Allocations PIs. 

$ OSCusage -A
$ OSCusage -A 01/01/2016 05/01/2016

No examples can be shown for this command. Please contact OSC Help with questions. 

Service: