Moab Accounting Manager > Appendices > Appendix A: Commands Reference > gtransfer

gtransfer

Synopsis

gtransfer {--from-fund <source_fund_id> &| --from-allocation <source_allocation_id> &| --from-filter <filter_name>=<filter_value>...} {--to-fund <destination_fund> &| --to-allocation <destination_allocation_id> &| --to-filter <filter_name>=<filter_value>...} [--filter-type <filter_type>] [-d <description>] [-h, --hours] [--debug] [--site <site_name>] [--help] [--man] [--quiet] [--verbose] [--version] {[-z] <amount>}

Overview

gtransfer issues a transfer between funds.

Options

-d
Format	-d <description>
Default	---
Description	Specifies the reason for the transfer. The annotation applies to the transaction description (seen via glstrans), not the allocation description.

-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 the amount to be specified in resource-hours.

-z
Format	[-z] <amount>
Default	---
Description	Specifies the amount to transfer.

--debug
Format	--debug
Default	---
Description	Logs debug information to the screen.

--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 NonExclusive filter type, MAM will match a fund as long as the specified filters do not conflict with the constraints.

--from-allocation
Format	--from-allocation <source_allocation_id>
Default	---
Description	Transfers credits from the specified allocation ID only. If you omit the allocation, only credits from active allocations will transfer in the order of earliest expiring first.

--from-filter
Format	--from-fund <filter_name=<filter_value>
Default	---
Description	If you specify one or more source filters and there is exactly one matching fund, MAM makes the transfer from that fund. Otherwise, it displays a list of funds for the specified filters and you will be prompted to respecify the transfer against one of the enumerated funds. You can specify multiple --from-filter options by logically ANDing them together.

--from-fund
Format	--from-fund <source_fund_id>
Default	---
Description	Specifies the fund to be debited.

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

--site
Format	--site <site_name>
Default	---
Description	Obtains a response from specified site.

--to-allocation
Format	--to-allocation <destination_allocation_id>
Default	---
Description	Transfers credits to the specified allocation ID only. If you omit the allocation, MAM transfers the credits to the allocation having the same start and end time as the source allocation the funds are taken from, or, if such an allocation is non-existent, MAM will create a new allocation in the target fund having the same start and end time.

--to-filter
Format	--to-filter <filter_name>-<filter_value>
Default	---
Description	If you specify one or more destination filters and there is exactly one matching fund, a transfer will be made to that fund. Otherwise, MAM displays a list of funds for the specified filters and you will be prompted to respecify the transfer against one of the enumerated funds. You may specify multiple --to-filter options by logically ANDing them together.

--to-fund
Format	--to-fund <destination_fund_id>
Default	---
Description	Specifies the fund to be credited.

--verbose
Format	--verbose
Default	---
Description	Displays modified object details.

--version
Format	--version
Default	---
Description	Displays the product version.