Subproject Allocation and Usage Command

The HPCMP grants users access to computational resources based on one or more subprojects. Subprojects are allocated a number of hours against which the users charge the time for their jobs. When users have an easy means to access current usage information, they are able to better manage their work and more accurately predict allocation requirements. Under this Baseline Configuration policy, each HPCMP center shall maintain a command named show_usage on all user-accessible systems. This command provides a report on the allocation and utilization of each subproject under which a user may compute.

The show_usage command produces two reports. The default report shows allocation and usage information for all subprojects under which the user has an account on this system. The second report, produced by the -s flag, shows the information for all the user’s subprojects on all systems at the local center. The command output may contain minor variations due to differences in which certain fields, such as subproject names and the precision of hours, are defined at each center. Centers may choose to enhance and/or restrict the command's reporting capabilities through the use of additional command-line options.

Default Report Format:

$ show_usage

          CENTER NAME - Subproject Usage Information (in CPU Hours)
                     As of 0000 hours CDT 26 October 2005
            Fiscal Year 2006 (01 October 2005 - 30 September 2006)
                 Fiscal Year Hours Remaining: 7440 ( 84.93%)

                             Hours      Hours      Hours    Percent  Background
System     Subproject      Allocated     Used    Remaining Remaining Hours Used
========== ============== ========== ========== ========== ========= ==========
systemA    proja123        1000000.0      366.1   999633.9    99.96%        0.0
systemA    projb456           5000.0     1493.3     3506.7    70.14%       12.5

Optional Report Format (-s):

$ show_usage -s

          CENTER NAME - Subproject Usage Information (in CPU Hours)
                     As of 0000 hours CDT 26 October 2005
            Fiscal Year 2006 (01 October 2005 - 30 September 2006)
                 Fiscal Year Hours Remaining: 7440 ( 84.93%)

                             Hours      Hours      Hours    Percent  Background
System     Subproject      Allocated     Used    Remaining Remaining Hours Used
========== ============== ========== ========== ========== ========= ==========
systemA    proja123        1000000.0      366.1   999633.9    99.96%        0.0
systemA    projb456           5000.0     1493.3     3506.7    70.14%       12.5
systemB    hhppc777         750000.0     5501.3   744498.7    99.27%        0.0
systemC    SUBPR12341567     60000.0    45666.8    14333.2    23.89%      111.4

Back to BC Policy FY10-06.