History Log Search Criteria dialog box


Use this dialog box to configure search criteria for history logs.

This dialog box is applicable to PATROL console only.

Configuration details

To access this dialog box, right-click the QHST node and select KM Commands > Configure Search CriteriaThis dialog box contains the following items:

Item

Description

Add

Click to open the history log search criteria configuration dialog box. Use this dialog box to define new history log search criteria.

Modify

Select a configured search criteria and click Modify to edit the configuration details.

Remove

Select a configured search criteria and click Remove to delete the configuration details.

Apply

Click to apply the configuration.

Close

Click to close the dialog box.


History Log Search Criteria configuration details

Item

Description

Search Criteria Name

Enter a unique name to be used for the search criteria. You must enter a name with no slashes, semicolons, or colons. Embedded blank spaces will be replaced with underscores. This name will be used to identify the instance of this search criteria under history log monitor.

Include Message IDs 

Enter the message IDs to search. By default all message IDs are included in the search. Input may also be a regular expression pattern.

Exclude Message IDs 

Enter the message IDs to exclude from the search. Input may also be a regular expression pattern.

Minimum Severity 

Enter the minimum severity of the selected messages. Specify a number between 0 and 99, inclusive, to indicate the minimum severity level on which to filter.

Text to Search 

Enter a text string to search for in the history log messages. The search text can be part of a word, an entire word, or a phrase. Input may also be a regular expression pattern.

Message Type 

Enter the message types to search. You can select or clear individual message types. By default, all the message types are selected.

  • *INFO - A message that provides general non error-related information.
  • *INQ - A message that conveys information but also asks for a reply.
  • *RQS - A message that contains a command for processing by a request processor, such as command entry.
  • *COMP - A message that conveys completion status of work.
  • *DIAG - A message that indicates errors in a system function, errors in an application, or errors in input data.
  • *NOTIFY - A message that describes a condition for which a program requires corrective action or a reply.
  • *ESCAPE - A message that describes a condition for which a program must end abnormally.
  • *RPY - A message that is a response to a received inquiry or notify message.
  • *COPY - A copy of an inquiry or notify message that is kept in the sender's message queue.

Trigger an event 

Select this option to instruct PATROL to trigger an event when the message is matched.

Select the Event Class

If you want to send an event to the PATROL Event Manager, select the event class for which to send the event. The available event classes are:

  • AKN_QHIST_OK
  • AKN_QHIST_INFO
  • AKN_QHIST_WARN
  • AKN_QHIST_ALARM
  • AKN_QHIST_NOTIFY

Select Event Data

If you want to send an event to the PATROL Event Manager, select the event data to include. When an Event Class and Event Data are specified for a message selection entry, the event data is passed to the event manager as a single argument. Within the argument, each selected piece of event data is included in the order specified below with each field separated from the next. by a tab. For example, when Message Id and Message Type are specified, description of the event appears as follows:
Id\t\tType

The following event data are available for selection:

  • Message Id
  • Message Type
  • Severity
  • Sending Job Id
  • Sending Job Name
  • User Name
  • Description

Apply

Click to apply the configuration.

Close

Click to close the dialog box.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*