Installer 10.15 | Complete Installation and Upgrade Information for Software AG Products | Command Central | Using the Command Line Interface | Inventory Commands | Specifying Search Criteria for Inventory Commands
 
Specifying Search Criteria for Inventory Commands
When using the inventory commands to list run-time components, products, fixes, and assets, you can specify search criteria to narrow the results that the command returns. Supply the search criteria using the following format:

attribute1=value1 attribute2=value2 ...
For the search criteria, you specify attribute values to match, for example runtimeComponentId=OSGI-CCE, where runtimeComponentId is the attribute and the value to match is OSGI-CCE.
Supported Search Criteria for Inventory Commands
The following table lists the attribute names you can use as a search criteria for each inventory command.
Command
Attribute Names
sagcc list inventory components
*nodeName
*nodeAlias
*nodeUrl
*environmentName
*environmentAlias
*runtimeComponentInfoId
*runtimeComponentId
*runtimeComponentDisplayName
*runtimeComponentProductId
*runtimeComponentCategory
*runtimeComponentRuntimeParentId
You can combine any of the pre-defined attribute names in this list with new search attributes added using sagcc create inventory components attributes.
sagcc list inventory fixes
*nodeName
*nodeAlias
*nodeUrl
*environmentName
*environmentAlias
*fixId
*fixDisplayName
*fixVersion
*fixGroup
*fixProducts
sagcc list inventory products
*nodeName
*nodeAlias
*nodeUrl
*environmentName
*environmentAlias
*productId
*productCanonicalId
*productDisplayName
*productParentId
*productGroup
*productProfileDir
*productCode
*productVersion
*productInstallTime
Specifying the Value
When specifying the value, you can include the * pattern-matching character to match multiple characters or the ? character to match a single character. For example, if you want to narrow the list of returned products to only those with “mws” anywhere in their product display names, use the following search criterion:
productDisplayName=*mws*
Important:
The search is case-sensitive.
You can also use the * and ? pattern-matching characters to search for attribute names. For example, if you want to list the search attributes attribute1=value1 and attribute2=value2 for different run-time components, use the following search criterion:
attribute?=value?
Logical Operators Used When Specifying Multiple Search Properties
If you specify multiple search items, by default, the command performs an AND operation to return results that match all the specified criteria. For example, to narrow the list of returned products to those with “mws” anywhere in their product display names and that are version 9.0 or later, use the following search criteria:
productDisplayName=*mws* productVersion=9.0*
You can use an OR operation with two attributes. To do so, specify the logicalOperator=OR argument. For example, to narrow the list of returned run-time components to those installed in installations that have the alias name “sag01” or “sag02”, use the following search criteria:
nodeAlias=sag01 logicalOperator=OR nodeAlias=sag02