Check Usage Status of CPU Points and Disk Space (showlim)

(Last update: Apr 23, 2024)

Resource (CPU points and disk space) usage statistics can be shown with showlim.

Show CPU points usage (showlim -c)

Allocated and used CPU points can be shown with "showlim -c" command. (Do not type the first $.)

$ showlim -c
========================================================================
CPU resource information: Group=*** (Unit: point)
SYSTEM       LIMIT      TOTAL-USE      ENDED-JOB    RUNNING-JOB
========================================================================
ccap         -----         54,326         54,321              5
------------------------------------------------------------------------
TOTAL    1,000,000         54,326         54,321              5

========================================================================
CPU resource information: User=*** / Group=*** (Unit: point)
SYSTEM       LIMIT      TOTAL-USE      ENDED-JOB    RUNNING-JOB
========================================================================
ccap         -----            325            325              0
------------------------------------------------------------------------
TOTAL        -----            325            325              0

In the former section (Group=*** only one), usage status of your group is shown. The latter (User=*** / Group=***) shows the usage status of you. In the example above, this group can use 1,000,000 points and 54,326 points are already used (5 points from currently running job(s) are included). You used 325 points so far.

  • "LIMIT" column: allocated CPU points
  • "TOTAL-USE" column: total amount of used CPU points
  • "ENDED-JOB" column: CPU points used by finished jobs
  • "RUNNING-JOB" column: CPU points used by currently running jobs

Although the points are shown in integer values, the points are actually real values internally. If 1-core job runs for 15 minutes (1/4 hours), 0.25 points will be consumed.

Show disk space usage (showlim -d)

Available and currently used disk space can be shown with "showlim -d" command. (Do not type the first $.)

$ showlim -d 
========================================================================
Disk resource information: Group=*** (Unit: GB)
        LIMIT            USE
========================================================================
       10,000          6,140

========================================================================
Disk resource information: User=*** (Unit: GB)
        LIMIT            USE
========================================================================
          ---          5,125

Group usage is shown in the first section. Your usage will be shown in the next section. In the example above, this group uses 6,140 GB of the 10,000 GB (=10 TB) limit. The user is using 5,125 GB now.

Show also group member's usage (-m option)

Usage of group members can be shown with -m option. This option is used in combination with "-c" or "-d". For example, disk usage of group members is shown below. CPU points usage of group members can be shown with "showlim -c -m".

$ showlim -d -m
========================================================================
Disk resource information: (Unit: GB)
USER                LIMIT            USE
========================================================================
**a                   ---             23
**b                   ---              0
**c                   ---              0
**d                   ---             56
**e                   ---            708
**f                   ---          5,125
**g                   ---              0
**h                   ---              0
**i                   ---            228
**j                   ---              0
------------------------------------------------------------------------
Total              10,000          6,140

When you belong to multiple groups (-g)

When you belong to multiple groups (SCCMS, library development, or other reasons), you may need to add "-g (group name)" option to see the status of subgroups. (e.g. showlim -c -g (group-name) to show CPU points usage of subgroup.) If you omit the -g option, resource usage status of primary group will be shown.

Please note that you can't distribute the disk usage to groups. (If you use 100 GB of disk space and belong to groups A and B, disk usage of both of groups A and B is increased by 100 GB. The group attributes of your files are not respected in these resource usage calculations.)

Notices on resource usage management

  • The statistics of CPU points and disk usage are calculated every 10 minutes. You may need to wait for some minutes until the renewal of values.
  • When the disk usage exceeds the limit, you and your group members can't submit new jobs anymore. Please remove data or request the extra disk space. Once the disk usage becomes within the limit, you can submit new jobs again.
View PDF