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:

ItemDescription
Search Criteria NameEnter 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 IDsEnter the message IDs to search. By default all message IDs are included in the search.
Exclude Message IDsEnter the message IDs to exclude from the search.
Minimum SeverityEnter the minimum severity of the selected messages.
TextSelect whether to include or exclude the text search results.
Text to SearchEnter 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 FileSelect 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 UserSelect 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 NameEnter 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.
ModifySelect one of the items that you added to the list in the preceding step, and click this option to modify the details.
RemoveSelect 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.
CloseClick to close the dialog box.

Screenshot of the Message Queue Criteria Configuration dialog box 

Was this page helpful? Yes No Submitting... Thank you
© Copyright 2019 BMC Software, Inc.
Legal notices