Message Queue Criteria Configuration dialog box


Use this dialog box to configure message queue search criteria for a defined message queue.

This dialog box is applicable to BMC PATROL Console only.

Configuration details

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

Item

Description

Search Criteria Name

Enter a unique name to be used for the search criteria. This field is required and can be a maximum of 28 characters. You must enter a name with no slashes, semicolons, or colons. Embedded blank spaces will be replaced with underscores.

Include Message IDs

Enter the message IDs to search. By default all message IDs are included in the search.

Exclude Message IDs

Enter the message IDs to exclude from the search.

Minimum Severity

Enter the minimum severity of the selected messages.

Text

Select whether to include or exclude the text search results.

Text to Search

Enter a text string to search for in the message queue. The search text can be part of a word, an entire word, or a phrase.

Message File

Select whether to include or exclude search results if they match the Message File criteria.

Message File Name

Enter the message file names to include or exclude from the search. By default all the message files are included in the search.

You can also use regular expressions to search for multiple matching instances.

Job and User

Select whether to include or exclude the search results if they match the Job Name and User Name criteria.

Job Name

Enter the job names to include or exclude from the search. By default all the job names are included in the search.

You can also use regular expressions to search for multiple matching instances.

User Name

Enter the name of the user associated with the job. By default all the user names are included in the search.

Message Type

Specify 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.

Add

Click this option for confirming the configuration information that you provided and adding the message queue to the list of configured message queues.

Modify

Select one of the items that you added to the list in the preceding step, and click this option to modify the details.

Remove

Select the items added earlier and click this option to delete that item from the list of configured search criteria and the clear the details provided in the earlier fields.

Apply

Click to apply the configuration.

Close

Click to close the dialog box.

Screenshot of the Message Queue Criteria Configuration dialog box

Message queue criteria configuration dialog box.png

 

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