Projects and charges

Listing project codes | Changing project codes | Controlling HPSS charges

Project codes

Every HPSS user has a default project code, which ties usage of the archive system to an account number and an allocation.

SAM image
Click for the Systems Accounting Manager.

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 multiple project codes. To get a list of your available project codes and determine which one is your HPSS 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, you can also do that in SAM.

Below are some HSI commands that will help you ensure that your HPSS 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 2018 23:05 myfile 

Changing project codes for files

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

[HSI]/home/username-> chacct UABC0002 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 either of the following.

  • Start the HSI session, then enter the newacct command and the desired project code:
[HSI]/home/username-> newacct UABC0002
  • Start your session as shown here:
hsi -a UABC0002

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 HPSS default.

Another alternative is to include the -a option in an individual HSI transfer command so your specified project code is used. Follow this example:

hsi -a UABC0002 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=UABC0002 -cv -f myncfile.tar *.nc

Controlling HPSS charges

Ways to control which project is charged for storage of a file or files are described above.

There are three ways to stop charges from accruing:

  • 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), contact CISL.