Configure Search Criteria - Define Search Criterion dialog box

File Name label

Displays the log full file path that will be monitored against the multiple regular expressions that you provided

SearchCriterion

This section allows you to define and modify search criterion settings for an individual search criterion.

Search Identifier text box

Enter an identification label for the search criterion. This must be unique for a text or XML instance. You can use the same search identifier in other text or XML instances, but not in the same text or XML instance. You can only use aplhanumeric characters such as a-z, A-Z, 0-9, and up to a maximum of 20 characters. This label appears in the Search list and helps you identify and modify the search criterion.

Not check box (Not applicable for an XML instance)

Select this check box to find the log file text line that does not contain the search string specified in the String1 text box. If you want to find the files that do contain the search string in the String1 field, ensure that this check box is not selected.

String1 text box

For a text instance, enter the first search string or the regular expression for the first search string that you want to search in the text instance (4096-byte limit). For an XML instance, enter the combination of XML elements and values that you want to find in the monitored file. For configuring XML search strings, see Rules for entering XML search strings. You can also enter multiple search patterns in this text box. Each search pattern must be a valid regular expression. You need to enclose each search pattern in parentheses ({ }). For example, you can enter {Pattern1} {Pattern2} {Pattern3}. For information about regular expressions, see Regular Expressions. The KM searches for each search pattern in the log file in the order in which you have specified the search patterns. These patterns are searched for the number of polling intervals that you specify in the Polling Intervals text box on the Configure Search Criteria: instanceName: Override Default Settings dialog box. If all the search patterns are not found in the specified polling intervals, PATROL generates an alarm. Note: BMC does not recommend performing the following actions:

• Entering multiple search patterns in the String1 text box and selecting the Always Read At Beginning check box in the Add File for Label: instanceName dialog box simultaneously.
• Entering a single search pattern in the String1 text box. The KM might not generate any alarm in that case. For example, if you enter {Job Started}, the KM might not generate an alarm.

Not checkbox (Not applicable for an XML instance)

Select this check box to find all files that do not contain the search string in the String2 text box. If you want to find the files that contain the search string in the String2 field, ensure that this check box is not selected.

String2 text box (Not applicable for an XML instance)

(optional) Enter the search string or the regular expression for the second search string that you want to search in the text instance (4096-byte limit).

First Number text box (Not applicable for an XML instance)

Enter a number to specify a starting position of a search range in the matched file.

Op list (Not applicable for an XML instance)

Select an operator.

Begin token text box (Not applicable for an XML instance)

Enter a valid beginning token value.

End token text box (Not applicable for an XML instance)

Enter a valid ending token value.

Op list (Not applicable for an XML instance)

Select an operator.

Second Number text box (Not applicable for an XML instance)

Enter a number to specify an ending position of a search range in the matched file line.

Next button

Click this button to continue configuring the instance and override the default settings for a particular search criterion in the Configure Search Criteria: instanceName: Override Default Settings dialog box.