Creating a usage record
In most cases, usage records will be created by the resource management system via the API or with the gquote, the greserve or the gcharge command.
However, it is also possible to create usage records directly using the gmkusage command:
gmkusage [-T usage_record_type] [-S service_id] [-u user_name] [-g group_name] [-a account_name] [-o organization_name] [-c class_name] [-Q quality_of_service] [-m machine_name] [-N nodes] [-P processors] [-C cpu_time] [-M memory] [-D disk] [-t usage_duration] [-s start_time] [-S service_id] [-e end_time] [-d description] [-X | --extension property=value]... [--debug] [--site site_name] [--help] [--man] [--quiet] [--verbose] [--version] {[-J] instance_name|job_id}
Example 10-1: Creating a usage record
$ gmkusage -u jsmith -a chem -m cluster -X Charge=2468 -P 2 -t 1234 -J PBS.1234.0
Successfully created 1 usage record with id 246
The fields which are displayed by default by this command can be customized by setting the usagerecord.show configuration parameter in gold.conf.
Use of the gmkusage command to record usage will not result in the debiting of a user's allocation. Use gcharge instead if you wish to charge for the usage.
Related topics