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

glslien

Synopsis

glslien [-A|-I] [-J <instance_pattern>] [-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>] [--full] [--show <attribute_name>,...] [--long] [--wide] [--format <output_type>] [-h,--hours] [--debug] [--site <site_name>] [--help] [--man] [--quiet] [--version] [[-l] <lien_id>]

Overview

glslien displays lien information.

You can customize the fields this command displays by default by setting the lien.show configuration parameter in gold.conf.

Options

-a
Format	-a <account_name>
Default	---
Description	Displays only liens against the specified account.

-A
Format	-A
Default	---
Description	Displays only unexpired liens.

-c
Format	-c <class_name>
Default	---
Description	Displays only liens against the specified class.

-g
Format	-g <group_name>
Default	---
Description	Displays only liens against 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.

-J
Format	-J <instance_pattern>
Default	---
Description	Displays only liens with the instance names (or job IDs) matching the pattern.

l
Format	[-l] <lien_id>
Default	---
Description	Displays only the specified lien.

-m
Format	-m <machine_name>
Default	---
Description	Displays only liens against the specified machine.

-o
Format	-o <organization_name>
Default	---
Description	Displays only liens against the specified organization.

-u
Format	-u <user_name>
Default	---
Description	Displays only liens against 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 liens where constraints do not conflict with the specified filters. For example, glslien -f User=amy will display liens usable by the user amy. You may specify multiple filter options by logically ANDing them together.

--filter-type
Format	--filter-type <filter_type>
Default	AttributedTo
Description	Selects the filtering type. If you use the AttributedTo filter type, the query returns all liens associated with usage records satisfying the filters. If you use the ImpingesUpon filter type, the query returns all liens affecting the balances of funds satisfying the filters.

--format
Format	--format <output_format>
Default	standard
Description	Specifies a data output format. Valid values include standard and csv.

--help
Format	--help
Default	---
Description	Displays a brief help message.

--long
Format	--long
Default	---
Description	Long format. Displays multi-valued fields in a multi-line format.

--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: Funds – List of funds that the lien has holds against. Allocations – List of allocations that the lien has holds against in the format <allocation_id><-<fund_id>=<reserved_amount>. Amount – Reserved amount. CreationTime – Time this lien was created. Deleted – Boolean indicating whether this lien is deleted or not. Description – Lien description. Duration – Expected duration of the reserved usage in seconds. EndTime – Time the lien becomes inactive. Id – Lien ID. Instance – The lien is against the specified instance (for instance, job ID). ModificationTime – Time this lien was last modified. RequestId – ID of the last modifying request. StartTime – Time the lien becomes active. TransactionId – ID of the last modifying transaction. UsageRecord – ID of the usage record associated with the lien and containing the usage properties.

--show

Format

--show <attribute_name>[,<attribute_name>...]

Default

---

Description

Displays only the specified attributes in the order specified. Valid attributes include the following:

Funds – List of funds that the lien has holds against.
Allocations – List of allocations that the lien has holds against in the format <allocation_id><-<fund_id>=<reserved_amount>.
Amount – Reserved amount.
CreationTime – Time this lien was created.
Deleted – Boolean indicating whether this lien is deleted or not.
Description – Lien description.
Duration – Expected duration of the reserved usage in seconds.
EndTime – Time the lien becomes inactive.
Id – Lien ID.
Instance – The lien is against the specified instance (for instance, job ID).
ModificationTime – Time this lien was last modified.
RequestId – ID of the last modifying request.
StartTime – Time the lien becomes active.
TransactionId – ID of the last modifying transaction.
UsageRecord – ID of the usage record associated with the lien and containing the usage properties.

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

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

--wide
Format	--wide
Default	---
Description	Wide format. Displays multi-valued fields in a single-line comma-separated format.