sbank Examples

Help Desk

Hours: 9:00am-5:00pm CT M-F
Telephone: 866-508-9181 (Toll-Free, US Only) or 630-252-3111
Email: support@alcf.anl.gov

Account and Project Management

Below is a set of helpful commands to help you better manage the projects you have running at the ALCF.

 

View your project's allocations

Use this command to list all of your active allocations for a specific project [Project-X]. This is useful when you need to provide this information in a report.

Command: sbank-list-allocations

> sbank-list-allocations -p ProjectX -r all
 Id         Start       End         Resource   Project          Jobs        Charged          Available Balance 
 ---------  ----------  ----------  ---------  ---------------  ----------  ---------------  ----------------- 
 2106       2016-01-04  2017-01-01  cooley     ProjectX              1,139          6,032.8           43,967.2 
 2146       2016-01-14  2017-01-10  theta      ProjectX                983      1,084,770.3       25,483,927.5 


Totals:
  Rows: 2
  Cooley:
    Available Balance: 43,967.2 node hours
    Charged          : 6,032.8 node hours
    Jobs             : 1,139 
 Theta:
    Available Balance: 25,483,927.5 core hours 
    Charged          : 1,084,770.3 core hours 
    Jobs             : 983 

List only the created timestamp field for all allocations that were created before 01-01-2015 for ProjectX accross all resources

> sbank-list-allocations  --created "<20150101" -r all -p ProjectX "-f created"
 Created    
 ---------- 
 2016-01-04 
 2016-01-14 
 2016-01-15 

Totals:
  Rows: 3
Date  filters (UTC): created < "2015-01-01 00:00:00",  
    

List all active allocations for all resources for project ProjectX and add the field Created to the display list

shrubbery~ > sbank-list-allocations -r all  -p ProjectX -f "+created"
 Id         Start       End         Resource   Project          Jobs        Charged          Available Balance  Created    
 ---------  ----------  ----------  ---------  ---------------  ----------  ---------------  -----------------  ---------- 
 279        2011-08-30  2020-01-01  theta      ProjectX              6,361     12,332,699.9      -12,332,699.9  2013-02-22 
 2106       2016-01-04  2017-01-01  cooley     ProjectX              1,150          6,080.9           43,919.1  2016-01-04  

Totals:
  Rows: 2
  Theta:
    Available Balance: -12,332,699.9 core hours
    Charged          : 12,332,699.9 core hours
    Jobs             : 6,361 
  Cooley:
    Available Balance: 43,919.1 node hours
    Charged          : 6,080.9 node hours
    Jobs             : 1,150 

List all available fields for the sbank-list-allocations command

> sbank-list-allocations  -f "?"
available fields:
 id
 start_timestamp
 end_timestamp
 resource
 project_name
 jobs_count
 charged_sum
 available_balance_sum
 created_timestamp
 award_category
 award_type_name
 admin_name
 cbank_ref
 comment

View your project's users

sbank-list-users

List all charges for userx on theta on project ProjectX

> sbank-list-users -p ProjectX -r theta -u userx
 User             Jobs        Charged         
 ---------------  ----------  --------------- 
 userx                 1,814          9,884.5

Totals:
  Rows: 1
  Resources: theta
  Charged: 9,884.5 core hours
  Jobs   : 1,814 

List charges for all users in ProjectX on cooley.

  • This works for project leads (i.e. PIs, Co-PIs, Proxies), since they can see everything in their own projects.
> sbank-list-users -p ProjectX -r theta
 User             Jobs        Charged         
 ---------------  ----------  --------------- 
 user1                   120          4,243.7 
 user2                     0              0.0 
 user3                     0              0.0 
 user4                   181          1,195.5 
 user5                     0              0.0 
 user6                 2,560         10,868.7 
 user7                     0              0.0 
 user8                     0              0.0 
 user9                     0              0.0 
 user10                    7              3.5 
 user11                    0              0.0 
 

Totals:
  Rows: 11
  Resources: theta
  Charged: 16,311.4 core hours
  Jobs   : 2,868 

View your project's jobs

sbank-list-jobs

list jobs for user "userx" for jobs that started in the range 2016-02-15<= started < 2016-02-29 and add the transactions related to the job

  • Note:
    • The job with the refund
    • transaction_ids_list field can be shorten all the way to "t" in the -f "+ t"
shrubbery~ > sbank-list-jobs -u userx -f "+ t" -S "2016-02-15...2016-02-29"
 Id         Jobid      Resource   Project          Allocation  User       Duration   Charged          Transaction Ids 
 ---------  ---------  ---------  ---------------  ----------  ---------  ---------  ---------------  --------------- 
 1013857    730417     theta       ProjectX         1740        userx      1:53:07           61,776.8  CHARGE-1011230  
 1013860    730558     theta       ProjectX         1740        userx      1:53:07           61,776.8  CHARGE-1011233  
 1014168    730668     theta       ProjectX         1740        userx      1:53:25           61,940.6  CHARGE-1011541  

Totals:
  Rows: 3
  Theta:
    Charged      : 185,494.2 core hours
    Duration     : 6:44:00 
Date  filters (UTC): "2016-02-15 00:00:00" <= start < "2016-02-29 00:00:00",  

List the nodes used, runtime and start timestamp for Cooley job 744160

Note to display the date and time we increased the the number of characters of start_timestamp to 19

catapult~ > sbank l j -r theta -j 50576 -f "jobid nodes_used runtime start_timestamp:19" Jobid Nodes Used Runtime Start --------- ---------- --------- ------------------- 50576 512 1:00:49 2013-01-16 21:49:30 Totals: Rows: 1

View your project's transactions

sbank-list-transactions

List of transactions that where at or after 2016-02-29 for ProjectX add fields: job_duration, nodes_used and hosts

  • ## Note the following:
    • job_duration, nodes_used and hosts are shorten, but they are still uniquely identified
    • host has the left justified width of 20, specified as "h:-20"
catapult~ > sbank-list-transactions -p ProjectX --at "ge 2016-02-29" -f "+ job_d nodes_u h:-20" -r theta
 Id         Resource   Project          Allocation  At          User             Transaction Type  Amount           Jobid      Job Duration  Nodes Used  Hosts                
 ---------  ---------  ---------------  ----------  ----------  ---------------  ----------------  ---------------  ---------  ------------  ----------  -------------------- 
 1025426    theta       ProjectX         2147        2016-02-29  userx            CHARGE                   48,005.1  740587     1:27:54       2048        MIR-00800-33BF1-2048 
 1028046    theta       ProjectX         2147        2016-03-01  userx            CHARGE                  147,647.1  742090     4:30:21       2048        MIR-40000-733F1-2048 
 1028755    theta       ProjectX         2147        2016-03-02  userx            CHARGE                1,576,068.0  742126     6:00:44       16384       MIR-04000-77FF1-1638 

Totals:
  Rows: 3
  Theta:
    Charges Amount: 1,771,720.2 core hours
    Job Duration  : 11:58:98 
Date  filters (UTC) : at >= "2016-02-29 00:00:00",