Projects and charges

Listing project codes | Changing project codes | Controlling HPSS charges

Project codes

Every HPSS user has a default project code. This code ties your usage to a related "account number" and allocation.

SAM image
Click for the Systems Accounting Manager.

Unless you specify otherwise, your default project code is used for the purpose of charging for HPSS storage. If you have a project code for charging jobs on computing resources, you can usually use the same project code for HPSS charges.

Some users have access to project codes for more than one project. To get a list of your available project codes and determine which one is your default, see the Systems Accounting Manager (SAM). You can also view your HPSS charges for each project.

Should you need to change your default project code at some point, such as when a project expires, that also is done in SAM..

Below are some HSI commands that will help you ensure that resource usage is charged to the correct project.

Listing project codes

To display your account number and current project code in an HSI session, enter newacct with no argument.

 [HSI]/home/username-> newacct 

The output shows your account number followed by your project code in parentheses, as in this example.

 Current account is: 11111111(UABC0001) 

To list files with their associated project codes, use ls -U.

Example: List the project code associated with "myfile."

 [HSI]/home/username-> ls -U myfile 

Sample output:

 -rwx------ 1 username ncar    1011       UABC0001 TAPE     471 Jul 27 2017 23:05 myfile 

Changing project codes for files

To change the project code associated with a file—for example, to associate "myfile" with UABC0001—use the chacct command:

[HSI]/home/username-> chacct UABC0001 myfile

If you are unable to change a file’s project code, either because you do not have permissions or because you are attempting to use a project code that you are not authorized to use, you will receive the following error message:

 *** chacct: Permission denied [-1: HPSS_EPERM] 

Be sure you are using the correct project code and confirm with your project lead that you are or should be authorized to make such a change.

Changing project code for an HSI session

To associate an individual HSI session with a non-default project code, do one of the following.

  • After you’ve signed in to HSI, enter the newacct command and the desired project code:
[HSI]/home/username-> newacct UABC0001
  • Or, on your command line, enter this to start a session:
hsi -a UABC0001

In those cases, the newacct value will apply for the duration of your HSI session or until you change it again. When the session ends, your project code will revert to the default.

  • As an alternative, you can include the -a option in an individual HSI transfer command so your specified project code is used. Follow this example:
hsi -a UABC0001 cput xxx : yyy

Changing project code for an HTAR transfer

To apply a specified project code to an HTAR transfer, follow this example:

htar -H acct=UABC0001 -cv -f myncfile.tar *.nc

Controlling HPSS charges

There are several ways to control which project is charged for storage of a file or files, as described above.

To stop charges from accruing, there are three methods:

  • Transfer the files from HPSS to local resources.
  • The project lead can request that orphaned files be deleted for users whose accounts have been closed.
  • CISL can assist in copying HPSS files to external media. To learn about charges for copying your files to external media, send a list of the files to be copied, and your preference for external media (for example, CD, DVD, USB2 device), to cislhelp@ucar.edu.

 

Related training courses