Making deposits
gdeposit is used to deposit time-bounded resource credits into a fund resulting in the creation or increase of an allocation. (See Managing allocations for information about managing allocations). The start time will default to -infinity and the end time will default to infinity if not specified. Filter options can be specified to help select a unique fund for the deposit. If multiple funds are matched by the filters, the matching funds will be listed and you will be prompted to respecify the deposit with one of the fund ids. If an allocation for the deposit fund is found having the start and end times for the deposit, the amount of the allocation will be increased by the deposit amount. Otherwise, a new allocation will be created for the fund with the amount of the deposit. If no funds match your criteria, if fund auto-generation is enabled, a fund will be created and the deposit made into it. Otherwise, the deposit will fail (the fund will need to be first created using gmkfund).
Deposits may be used to extend the debit ceiling by specifying an amount for the deposit (with the -z option) or extend the credit floor by specifying a credit limit for the deposit (with the -L option) or a combination of both options may be used. Additionally, Infinity may be used for either of these option values when Moab Accounting Manager is coupled with a database that supports IEEE Standard 754 for Floating-Point Arithmetic (e.g. PostgreSQL).
gdeposit [-L credit_limit] [-s start_time] [-e end_time] [-d description] [-f fund_id] [-i allocation_id] [-u user_name] [-g group_name] [-a account_name] [-o organization_name] [-c class_name] [-m machine_name] [--filter filter_name=filter_value]... [--filterType Exclusive|NonExclusive] [--create-fund True|False] [--reset] [-h, --hours] [--debug] [--site site_name] [--help] [--man] [--quiet] [--verbose] [--version] [[-z] amount]
Example 6-9: Making a deposit into fund 1
$ gdeposit -z 360000000 -f 1
Successfully created 1 allocation
Example 6-10: Making a deposit "into" an account
If an account has a single fund then a deposit can be made against the account.
$ gdeposit -z 360000000 -a chemistry
Successfully deposited 360000000 credits into fund 2
Example 6-11: Creating a credit allocation
$ gdeposit -L 10000000000 -f 3
Successfully created 1 allocation
Example 6-12: Making a reset deposit
Stop the active allocation within a fund and create a new allocation.
$ gdeposit -f 4 -z 36000000 --reset
Successfully deposited 36000000 credits into fund 4
Successfully stopped 1 allocation
Successfully created 1 allocation
Example 6-13: Creating an infinite allocation
$ gdeposit -z Infinity -f 5
Successfully deposited inf credits into fund 5
Successfully created 1 allocation
The use of infinite allocations requires the use of a database that supports the IEEE Standard 754 for Floating-Point Arithmetic (e.g. PostgreSQL).
Example 6-14: Creating a future quarterly allocation
$ gdeposit -s 2014-10-01 -e 2015-01-01 -z 25000000 -a biology
Successfully created 1 allocation
Related topics