chgname search command

This topic contains the following information:

• • Syntax
  • Short examples
  • Long example
  • Notes

For a list of all search commands, see Search-commands.

Syntax

chgname <Source-Field> with <Target-Field>+

In the preceding syntax, the following definitions apply:

• + indicates one or more similar expressions separated by a comma (,) or space.
• <Source-Field> refers to the field that you want to rename.
• <Target-Field> refers to the new field name with which you want to replace the existing field name.
• "<Phrase>" refers to the phrase with which you want to replace the existing field name. You must enclose a phrase in double quotes (").

Short examples

Example 1: Rename the COMPID field with ComponentID:

Long example

The following sample data and sample indexed data (displayed on the Search tab) will help you understand the examples of using the chgname command.

• Sample data
• Sample indexed data
• chgname for multiple fields
•  

Sample data

Back to examples ↑

Sample indexed data

Back to examples ↑

chgname for multiple fields

In this example, you use the command to replace an existing field name with a new field name. See sample indexed data to understand how this command functions and to correlate the resulting output:

Command

Output

Back to examples ↑

Notes

• After replacing the name of a particular field with a new name, you cannot search for the new name.

• You cannot rename an existing (single) field with multiple names. For example, with an existing field X, you cannot replace X with Y and then replace X with Z in one search string.
• You cannot rename the default fields HOST, COLLECTOR_NAME, and DATA_PATTERN.
• You cannot use default field names to specify a target field.
• You cannot click a renamed field (or tag) to add it to the Fields section (on the Filters panel) or to your search criteria. However, you can use it in a subsequent search command by adding it to your search criteria.