Command Central 10.3 | Command Central Developer Reference | Using the Command Line Interface | Lifecycle Commands | Specifying Search Criteria for Lifecycle Commands
 
Specifying Search Criteria for Lifecycle Commands
When executing the sagcc exec lifecycle command on a Command Central server, you can specify search criteria to identify the run-time components against the command should act. Supply the search criteria using the following format:
[logicalOperator=OR] 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.
Specifying the Value
When specifying the value, you can include the * pattern-matching character to match multiple characters. For example, if you want to act only on run-time components with “cce” anywhere in their display names, use the following search criterion:
displayName=*cce*
Important:
The search is case-sensitive.
Attribute Names You Can Use in the Search Criteria
*nodeName
*nodeAlias
*nodeUrl
*environmentName
*environmentAlias
*runtimeComponentInfoId
*runtimeComponentId
*runtimeComponentDisplayName
*runtimeComponentProductId
*runtimeComponentCategory
*runtimeComponentRuntimeParentId
You can combine any of the attribute names in this list with new search attributes added using the sagcc create inventory components attributes command. For more information about syntax and usage, see sagcc create inventory components attributes.
Logical Operators Used When Specifying Multiple Search Attributes
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 act only on run-time components with “cce” anywhere in their display names and that are part of products that have the ID “OSGI”, use the following search criteria:
displayName=*cce* productId=OSGI
You can use an OR operation with two attributes. To do so, specify the logicalOperator=OR argument. For example, to act on run-time components with “cce” anywhere in their display names or that are part of products that have the ID “OSGI”, use the following search criteria:
displayName=*cce* logicalOperator=OR productId=OSGI