Using Qbank on Jazz Documentation



	Using Jazz \| Getting Started \| About the LCRC \| Presentations \| Status \| FAQ \| Search \| Main Page

Managing Project Compute Hour Allocations on Jazz using QBank

Jazz project computer time allocations are managed on the Jazz cluster using the QBank package. This document describes how a user can set their default project, check current project balances, etc. Rather than have the user use the actual QBank commands, which are somewhat obscure and inconsistent with options, a single command 'lcrc-qbank' is provided to query and set various data in the QBank database. Users only have permissions to query and modify their own data unless they are Principal Investigators (PIs) for a project. Because administration of a project is complex, PIs should use the Jazz Project Management pages to query and set the project data.

Usage: lcrc-qbank 

Query and set QBank allocation information.

Options:
  -h            print this message.
  -d            print lots of output.
  -p <project>  take action for project specified only.


  -s  default <project>

      default: set the default project. <project> must be the name of a
               valid project and must be the last word on the line.

  -q [default|balance|trans]

      default: print the current default project.
      balance: print the current balances for all projects unless
               -p option is used.
        trans: print the transactions for all projects unless
               -p option is used. To sort transactions, use
               the --sortby option.

  -b <MM/DD/YY> restrict transactions to those on or after specified date.
  -e <MM/DD/YY> restrict transactions to those on or prior to specified date.

 --sortby [date|jobid|user|none]  only valid with -q trans option.

Command Result

query balance Use to view current balances for all projects. The default project is marked with a *.

[joeuser]$ lcrc-qbank -q balance Project: Available (Nodehours) ---------------- --------------------- *startup-joeuser 769.3864 anl-mcs-support 10000.0000

query default Use to view current default project.

[joeuser]$ lcrc-qbank -q default Default Project: startup-joeuser

query trans Use to view transactions. To see transactions for a specific project, use the -p <project> option, otherwise all transactions for all projects will be shown, grouped by project. To see only transactions after a specific date, use the -b option, otherwise all transactions will be shown. To see only transactions on or prior to a specific date, use the -e option, otherwise all transactions will be shown.

[joeuser]$ lcrc-qbank -q trans

[joeuser]$ lcrc-qbank -q trans -p anl-mcs-support

[joeuser]$ lcrc-qbank -q trans -b "02/14/03" -e "02/15/03" -p anl-mcs-support

set default Use to set the default project to a different project. If a user does not specify a project at job submission, the resources used will be withdrawn from the default project at the time of job completion. The project must be a valid project and the user must be a member of the project. If the requested project is the same as the current default project, the request will be ignored.

[joeuser]$ lcrc-qbank -s default anl-mcs-support Previous Default Project: startup-joeuser New Default Project: anl-mcs-support

Command	Result
query balance	Use to view current balances for all projects. The default project is marked with a . [joeuser]$ lcrc-qbank -q balance Project: Available (Nodehours) ---------------- --------------------- startup-joeuser 769.3864 anl-mcs-support 10000.0000
query default	Use to view current default project. [joeuser]$ lcrc-qbank -q default Default Project: startup-joeuser
query trans	Use to view transactions. To see transactions for a specific project, use the -p <project> option, otherwise all transactions for all projects will be shown, grouped by project. To see only transactions after a specific date, use the -b option, otherwise all transactions will be shown. To see only transactions on or prior to a specific date, use the -e option, otherwise all transactions will be shown. [joeuser]$ lcrc-qbank -q trans [joeuser]$ lcrc-qbank -q trans -p anl-mcs-support [joeuser]$ lcrc-qbank -q trans -b "02/14/03" -e "02/15/03" -p anl-mcs-support

set default	Use to set the default project to a different project. If a user does not specify a project at job submission, the resources used will be withdrawn from the default project at the time of job completion. The project must be a valid project and the user must be a member of the project. If the requested project is the same as the current default project, the request will be ignored. [joeuser]$ lcrc-qbank -s default anl-mcs-support Previous Default Project: startup-joeuser New Default Project: anl-mcs-support

Help Security/Privacy Notice Disclaimer