gdeposit
Synopsis
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>]... [--filter-type <filter_type>] [--create-fund=<boolean>] [--reset] [-h, --hours] [--debug] [--site <site_name>] [--help] [--man] [--quiet] [--verbose] [--version] [[-z] <amount>]
Overview
gdeposit makes time-bound deposits into funds. After applying all filter options, if there is exactly one debitable fund for the specified criteria, MAM makes a deposit into that fund. If multiple funds match the specified criteria, MAM displays a list of matching funds and prompt you to respecify the deposit against one of the enumerated funds. If no funds match your criteria, if auto-generation is turned on for the fund object, or the --create-fund flag is asserted, MAM creates a fund and make a deposit into it; otherwise, the deposit fails (the fund will need to be created with gmkfund).
Options
| -a |
| Format |
-a <account_name>
|
| Default |
--- |
| Description |
Restricts the fund for the deposit to one usable by the specified account. |
| -c |
| Format |
-c <class_name>
|
| Default |
--- |
| Description |
Restricts the fund for the depositto one usable by the specified class. |
| -d |
| Format |
-d <description>
|
| Default |
--- |
| Description |
Specifies the reason for the deposit. The annotation applies to the transaction description (seen via glstrans), not the allocation description. |
| -e |
| Format |
-e <end_time>
|
| Default |
Infinity
|
| Description |
Specifies the end time for the allocation to be credited in the format:
YYYY-MM-DD[ hh:mm:ss]|-Infinity|Infinity|Now
|
| -f |
| Format |
-f <fund_id>
|
| Default |
Infinity
|
| Description |
Specifies the ID of the fund into which the deposit will be made.
|
| -g |
| Format |
-g <group_name>
|
| Default |
--- |
| Description |
Specifies that the fund for the deposit should be restricted to one usable by the specified group. |
| -h |
| Format |
-h or --hours |
| Default |
--- |
| Description |
Treats currency as specified in hours. In systems where the
currency is measured in resource-seconds (like processor-seconds),
this option allows you to specify the amount and credit limit in resource-hours. |
| -i |
| Format |
-i <allocation_id>
|
| Default |
--- |
| Description |
Specifies the allocation in which to make the deposit. This option is incompatible with the -L option. |
| -L |
| Format |
-L <credit_limit>
|
| Default |
--- |
| Description |
Creates a new allocation with the specified credit limit. This option is incompatible with the -i option. |
| -m |
| Format |
-m <machine_name>
|
| Default |
--- |
| Description |
Restricts the fund for the deposit to one usable by the specified machine. |
| -o |
| Format |
-o <organization_name>
|
| Default |
--- |
| Description |
Restricts the fund for the deposit to one usable by the specified organization. |
| -s |
| Format |
-s <start_time>
|
| Default |
Infinity
|
| Description |
Specifies the start time for the allocation to be credited in the format:
YYYY-MM-DD[ hh:mm:ss]|-Infinity|Infinity|Now
|
| -u |
| Format |
-u <user_name>
|
| Default |
--- |
| Description |
Restricts the fund for the deposit to one usable by the specified user. |
| -z |
| Format |
[-z] <amount> |
| Default |
--- |
| Description |
Specifies the amount to deposit. |
| --create-fund |
| Format |
--create-fund <boolean>
|
| Default |
--- |
| Description |
Overrides the fund auto-generation setting.
Setting this option to True creates a default fund for this
deposit. Setting this option to False inhibits the creation of
a default fund for this deposit. |
| --debug |
| Format |
--debug
|
| Default |
--- |
| Description |
Logs debug information to the screen.
|
| --filter |
| Format |
--filter <filter_name>=<filter_value>
|
| Default |
--- |
| Description |
Restricts the fund to one where constraints do not conflict with the specified filters. For example, gchfund --filter User=amy restricts the fund to one usable by the user amy. You may specify multiple filter options by logically ANDing them together.
|
| --filter-type |
| Format |
--filter-type <filter_type>
|
| Default |
NonExclusive
|
| Description |
Specifies the filtering type. If you use the exclusive filter type, MAM will only match a fund if the specified filters meet all constraints. If you use the non-exclusive filter type, MAM will match a fund as long as the specified filters do not conflict with the constraints.
|
| --help |
| Format |
--help
|
| Default |
--- |
| Description |
Displays a brief help message.
|
| --man |
| Format |
--man
|
| Default |
--- |
| Description |
Displays full documentation.
|
| --quiet |
| Format |
--quiet
|
| Default |
--- |
| Description |
Suppresses headers and success messages.
|
| --reset |
| Format |
--reset
|
| Default |
--- |
| Description |
Ends the current allocation and creates a new allocation with the deposit. |
| --site |
| Format |
--site <site_name>
|
| Default |
--- |
| Description |
Obtains a response from specified site. |
| --verbose |
| Format |
--verbose
|
| Default |
--- |
| Description |
Displays modified object details.
|
| --version |
| Format |
--version
|
| Default |
--- |
| Description |
Displays the product version.
|
Related topics