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 reservation 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 reservation 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.

To request a usage quote, use the command gquote:

gquote [-T usage_record_type] [-u user_name] [-g group_name] [-p project_name] [-o organization] [-c class_name] [-Q quality_of_service] [-m machine_name] [-N nodes] [-P processors] [-M memory] [-D disk] [-n network] [-X, --extension property name=property_value[,property_name=property_value...]] [-t quote_duration] [-G grace_duration]] [-s quote_start_time] [-e quote_end_time] [-d quote_description] [-z quote_amount] [--itemizedCharges itemized_charges] [--costOnly | --guarantee] [-R charge_rate_type:charge_rate_name[{charge_rate_instance}]=charge_rate_amount[,charge_rate_type:charge_rate_name[{charge_rate_instance}]=charge_rate_amount...]] [--debug] [-?, --help] [--man] [--quiet] [-v, --verbose] [-V, --version] [[-j] usage_record_id] [-q quote_template_id] [-J] instance_name|job_id]

Additional detail for this command can be found in the man page by issuing gquote --man at the command line.

Example 5. Requesting a quotation

$ gquote -p chemistry -u amy -m colony -P 2 -t 3600
Successfully quoted 7200 credits

Example 6. Requesting a guaranteed quote

$ gquote -p 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          2012-04-06 10:09:58  2012-04-06 11:09:58 3600      0     VBR:Processors:1

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).