Obtaining usage quotes
Usage quotes can be used to determine how much it will cost to use a resource or service. Provided the cost-only option is not specified, this step will additionally verify that the submitter has sufficient funds and meets all the allocation policy requirements for the usage, and can be used at the submission of the usage request as an early filter to prevent the usage from getting blocked when it tries to obtain a lien to start later. If a guaranteed quote is requested, a quote id is returned and can be used in the subsequent charge to guarantee the rates that were used to form the original quote. A guaranteed quote has the side effect of creating a quote record and a permanent usage record. A quote id will be returned which can be used with the lien and charge to claim the quoted charge rates. A cost-only quote can be used to determine how much would be charged for usage without verifying sufficient funds or checking to see if the charge could succeed. A breakdown of the charges in the quote can be returned by specifying the --itemize option with the --verbose option.
To request a usage quote, use the command gquote:
gquote [-T usage_record_type] [-S service_id] [-u user_name] [-g group_name] [-a account_name] [-o organization] [-c class_name] [-Q quality_of_service] [-m machine_name] [-N nodes] [-P processors] [-C cpu_time] [-M memory] [-D disk] [-X, --extension property=value]... [-t quote_duration [-G grace_duration]] [-s quote_start_time] [-e quote_end_time] [-d quote_description] [-z quote_amount] [--cost-only | --guarantee] [-R charge_rate_name[{charge_rate_value}]=charge_rate_amount,...]... [-h, --hours] [--itemize] [--debug] [--site site_name] [--help] [--man] [--quiet] [--verbose] [--version] [[-j] usage_record_id] [-q quote_template_id] [-J instance_name|job_id]
Example 10-5: Requesting a quote
$ gquote -a chemistry -u amy -m colony -P 2 -t 3600
Successfully quoted 7200 credits
Example 10-6: Requesting a guaranteed quote
$ gquote -a chemistry -u amy -m colony -P 16 -t 3600 --guarantee
Successfully quoted 57600 credits with quote id 1 and usage record id 86
$ glsquote
Id Amount UsageRecord StartTime EndTime Duration Used ChargeRates Description
--- ------- ----------- ------------------- ------------------- --------- ----- ---------------- -------------
1 57600 86 2014-04-06 10:09:58 2014-04-06 11:09:58 3600 0 Processors:1/s
It is possible to establish a system default machine, project or user to be used in job functions (charge, reserve or quote) when left unspecified (see Server configuration).
Related topics