Command Central 10.3 | Command Central Developer Reference | Using the Command Line Interface | Inventory Commands | sagcc list inventory components | 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 assets
*nodeAlias
The alias of the installation on which the asset is installed
*runtimeComponentId
The ID of the run-time component to which the asset belongs.
*name
The name of the installed asset.
*version
The version of the installed asset.
*runtimeType
The type of the asset runtime. Valid values to match:
AppPlatform
BPM
DES
EDA
IS
MWS
RULES
RULESMWS
TN
*type
The type of the asset. The type is product-specific, for example for Integration Server the type is ispackage.
For information about the asset types, see webMethods Deployer User’s Guide.
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