glsalloc
Synopsis
glsalloc [-A | -I | {[-s <start_time>] [-e <end_time>]}] [-f <fund_id>] [-X, --extension <property>=<value>]... [-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>] [--include-ancestors] [--full] [--show <attribute_name>,...] [--format <output_type>] [-h, --hours] [--debug] [--site <site_name>] [--help] [--man] [--quiet] [--version] [[-i] <allocation_id>]
Overview
glsalloc displays allocation information.
You can customize the fields this command displays by defaul by setting the allocation.show configuration parameter in gold.conf.
Options
| -a |
| Format |
-a <account_name>
|
| Default |
--- |
| Description |
Displays only allocations usable by the specified account. |
| -A |
| Format |
-A
|
| Default |
--- |
| Description |
Displays only active allocations. |
| -c |
| Format |
-c <class_name>
|
| Default |
--- |
| Description |
Displays only allocations usable by the specified class. |
| -e |
| Format |
-e <end_time>
|
| Default |
--- |
| Description |
Displays only allocations that start before the specified end time. |
| -f |
| Format |
-f <fund_id>
|
| Default |
--- |
| Description |
Displays only the allocations associated with the specified fund. |
| -g |
| Format |
-g <group_name>
|
| Default |
--- |
| Description |
Displays only allocations usable by the specified group. |
| -h |
| Format |
-h or --hours |
| Default |
--- |
| Description |
Displays time-based credits in hours. In cases where the currency is measured in resource-seconds (like processor-seconds), the currency is divided by 3600 to display resource-hours. |
| -i |
| Format |
[-i] <allocation_id>
|
| Default |
--- |
| Description |
Displays only the allocation with the specified ID. |
| -I |
| Format |
-I
|
| Default |
--- |
| Description |
Displays only inactive allocations. |
| -m |
| Format |
-m <machine_name>
|
| Default |
--- |
| Description |
Displays only allocations usable by the specified machine.
|
| -o |
| Format |
-o <organization_name>
|
| Default |
--- |
| Description |
Displays only accounts usable to the specified organization.
|
| -s |
| Format |
-s <start_time>
|
| Default |
--- |
| Description |
Displays only allocations that end after the specified start time.
|
| -u |
| Format |
-u <user_name>
|
| Default |
--- |
| Description |
Displays only allocations usable by the specified user. |
| -X |
| Format |
-X or --extension <property>=<value> |
| Default |
--- |
| Description |
Specifies an extension property. You can specify any number of extra custom conditions. |
| --debug |
| Format |
--debug
|
| Default |
--- |
| Description |
Logs debug information to the screen.
|
| --filter |
| Format |
--filter <filter_name>=<filter_value>
|
| Default |
--- |
| Description |
Displays allocations where fund constraints comply with the
specified filters. For example, glsfund --filter User=amy displays funds usable by the user amy. You can 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 exclusive filter type, MAM only matches a fund if the specified filters meet all constraints. If you specify the non-exclusive filter type, MAM matches a fund as long as the specified filters do not conflict with
the constraints. |
| --format |
| Format |
--format <output_format>
|
| Default |
standard |
| Description |
Specifies a data output format. Valid values include standard and csv. |
| --full |
| Format |
--full |
| Default |
--- |
| Description |
Displays all attributes. |
| --help |
| Format |
--help
|
| Default |
--- |
| Description |
Displays a brief help message.
|
| --include-ancestors |
| Format |
--include-ancestors
|
| Default |
--- |
| Description |
Includes ancestors of the selected allocations. |
| --man |
| Format |
--man
|
| Default |
--- |
| Description |
Displays full documentation.
|
| --quiet |
| Format |
--quiet
|
| Default |
--- |
| Description |
Suppresses headers and success messages.
|
| --show |
| Format |
--show <attribute_name>[,<attribute_name>...]
|
| Default |
--- |
| Description |
Displays only the specified attributes in the order specified.
Valid attributes include the following:
-
Active – Boolean indicating whether this allocation is active or not.
Adjustments – Total of subsequent adjustments to the initial deposit via deposits, withdrawals or transfers (Allocated - InitialDeposit).
- Allocated – Adjusted allocation. This value stores the effective allocated amount based on the initial deposit and subsequent allocation adjustments via deposits, withdrawals or transfers.
-
Amount – Allocated amount.
-
Available – Amount currently available for charging (Amount - Reserved + CreditLimit).
- Balance – Allocation amount not blocked by liens (Amount - Reserved).
- Capacity – Total expendable amount (Allocated + CreditLimit).
- CreationTime – How far in the negative this allocation is permitted to be used (enforced in quotes and liens).
- CreditLimit – Time this allocation was created.
- Deleted – Boolean indicating whether this allocation is deleted or not.
- Description – Allocation description.
- EndTime – Time this allocation becomes inactive.
- Fund – Fund ID.
- FundName – Fund name.
- Id – Allocation ID.
- InitialDeposit – Amount of the first deposit into this allocation.
- ModificationTime – Time this allocation was last modified.
- PercentUsed – Percentage of allocation used (Used * 100 / Capacity).
- Remaining – Synonymous with Amount.
- PercentRemaining – Percentage of allocation remaining (remaining * 100 / Capacity).
- Reserved – Sum of active lien amounts against this allocation.
- RequestId – ID of the last modifying request.
- StartTime – Time this allocation becomes active.
- TransactionId – ID of the last modifying transaction.
- Used – Amount used from this allocation (Allocated - Amount).
|
| --site |
| Format |
--site <site_name>
|
| Default |
--- |
| Description |
Obtains a response from specified site. |
| --version |
| Format |
--version
|
| Default |
--- |
| Description |
Displays the product version.
|
Related topics