Service Unit Utilization

Gold provides several commands for users to retrieve historical data about service unit charges.

Project access

All users have a default account, which can be determined with glsuser.

>glsuser `whoami`
Name    Active CommonName PhoneNumber EmailAddress DefaultAccount Description 
------- ------ ---------- ----------- ------------ -------------- ----------- 
defusco True                                       sam                     

Access to other projects may also be granted and those projects will appear in the output of mybalance below.

Current Available Balance

The mybalance command will show the current available balance in all projects to which the user has access. Most users of Frank will only have access to one project. The -h flag is used to show the balance in hours. Remember that nodes in the SharedMem and DistributedMem have different scale factors when a charge is made.

>mybalance -h
Name          Available  
------------- ---------- 
SaM           6371842.79 
adefusco        65304.14 
mpix-spring15    9934.65 
che2017          9920.82

Job Charges

To view the charge applied or reserved for each job, use glsjob. In the table shown below all jobs will be show with the service units that were charged for the job along with running jobs that are identified by amount of service units that are reserved for the job. Note that while the Charge is represented in hours, the WallDuration is in seconds.

>glsusage -h -u `whoami`
Id     Type Instance Charge Stage  User    Group Account Organization Class       QualityOfService Machine Nodes Processors CPUTime Memory Disk Duration StartTime           EndTime             Description 
------ ---- -------- ------ ------ ------- ----- ------- ------------ ----------- ---------------- ------- ----- ---------- ------- ------ ---- -------- ------------------- ------------------- ----------- 
384655 Job  1599068    0.05 Charge defusco sam   sam                  interactive investor         pbs     1     3                              62       2015-04-07 11:37:08 2015-04-07 11:38:10             
384656 Job  1599069    0.09 Charge defusco sam   sam                  interactive investor         pbs     1     5                              63       2015-04-07 11:37:39 2015-04-07 11:38:42             
384657 Job  1599070    0.03 Charge defusco sam   sam                  interactive investor         pbs     1     1                              95       2015-04-07 11:38:10 2015-04-07 11:39:45             
384658 Job  1599071    1.10 Charge defusco sam   sam                  interactive investor         pbs     1     2                              1985     2015-04-07 11:38:42 2015-04-07 12:11:47             
384659 Job  1599072    1.63 Charge defusco sam   sam                  interactive investor         pbs     1     3                              1953     2015-04-07 11:39:14 2015-04-07 12:11:47             
384660 Job  1599073    1.60 Charge defusco sam   sam                  interactive investor         pbs     1     3                              1922     2015-04-07 11:39:45 2015-04-07 12:11:47

Project Statement

All jobs that were charged to a particular project along with deposits made can be displayed by gstatement. The default project for every user is the same name of his or her primary group.

>gstatement -h -a `groups | awk '{print $1}'`
################################################################################
#
# Includes fund 1 (SaM)
# Generated on Mon May  4 16:46:40 2015.
# Reporting fund activity from 2015-04-01 to Now.
#
################################################################################
 
Beginning Balance:              8432.62
------------------ --------------------
Total Credits:                     0.00
Total Debits:                    -19.80
------------------ --------------------
Ending Balance:                 8412.82
 
############################### Credit Detail ##################################
 
 
############################### Debit Detail ###################################
 
Object      Action Instance Account User    Machine Amount Balance Time                
----------- ------ -------- ------- ------- ------- ------ ------- ------------------- 
UsageRecord Charge 1599068  sam     defusco pbs      -0.05 8432.57 2015-04-07 11:38:10 
UsageRecord Charge 1599069  sam     defusco pbs      -0.09 8432.48 2015-04-07 11:38:42 
UsageRecord Charge 1599070  sam     defusco pbs      -0.03 8432.45 2015-04-07 11:39:45 
UsageRecord Charge 1599073  sam     defusco pbs      -1.60 8428.12 2015-04-07 12:11:47 
UsageRecord Charge 1599072  sam     defusco pbs      -1.63 8429.72 2015-04-07 12:11:47 
UsageRecord Charge 1599071  sam     defusco pbs      -1.10 8431.35 2015-04-07 12:11:47 
UsageRecord Charge 1599075  sam     defusco pbs      -0.06 8428.06 2015-04-07 15:13:58 
UsageRecord Charge 1599076  sam     defusco pbs      -0.01 8428.05 2015-04-30 09:24:50 
UsageRecord Charge 1599077  sam     defusco pbs      -3.09 8424.97 2015-04-30 10:26:35 
UsageRecord Charge 1599079  sam     defusco pbs      -0.04 8424.92 2015-04-30 11:01:34 
UsageRecord Charge 1599080  sam     defusco pbs      -1.02 8420.80 2015-04-30 12:02:36 
UsageRecord Charge 1599078  sam     defusco pbs      -3.10 8421.82 2015-04-30 12:02:36 
UsageRecord Charge 1599081  sam     defusco pbs      -0.05 8420.75 2015-04-30 14:22:50 
UsageRecord Charge 1599082  sam     defusco pbs      -0.67 8420.08 2015-04-30 15:02:58 
UsageRecord Charge 1599083  sam     defusco pbs      -7.26 8412.82 2015-04-30 15:25:05 
 
############################### End of Report ##################################