Subproject Allocation and Usage Command

(Initially established as BC Policy FY06-03, 26 October 2005)

The HPCMPO grants users access to computational resources based on one or more subprojects. Subprojects are allocated a specified number of hours against which the users charge the time for their job runs. 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 center shall maintain a command named show_usage. This command provides a report on the allocation and usage status of each subproject under which a user may compute.

The show_usage command shall produce two reports. The default report shows allocation and usage information for all subprojects under which the user has an account on the current system. The second report, produced by the -s flag, shows allocation and usage information for all subprojects under which the user has an account 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