Registration

Dear SAP Community Member,
In order to fully benefit from what the SAP Community has to offer, please register at:
http://scn.sap.com
Thank you,
The SAP Community team.
Skip to end of metadata
Go to start of metadata

Using central user-defined message search



About

You can use the user-defined message search options to find a message by specific information contained in the message header or the payload.

For example, you need to find the status of a message for which you know only the following details:

  • It that was processed the last week. This is information contained in the message header.
  • It contained a certain sales order number. This is information contained in the message payload, for example <OrderNumber>12345678</OrderNumber>.
  • It was processed using a certain interface. This is information contained in the message header.

You can perform such a centralized search for all systems in PI domain (including decentral Adapter Engines and ABAP Proxies) using the Technical Monitoring Work Center in SAP Solution Manager.

Prerequisites

Each system in the PI domain in which you want to search centrally must be configured to index messages. The systems index only messages that contain a set of header and payload information you have defined. You would be able to search centrally only messages that have already been indexed locally on the corresponding system in the PI domain.

For more information about defining search criteria in advance, see Configuring User-Defined Message Search (AS Java) and Configuring the User-Defined Message Search (AS ABAP).

Procedure

  1. Access the Technical Monitoring Work Center in SAP Solution Manager and choose PI Monitoring.
  2. Select a domain and choose Message Search.
  3. Enter the general search options as follows:
    • Specify the time period in which the messages have been processed.
    • Select the systems on which you want to search messages.
      You can use the Ctrl key to select more than one system.
    • In the Search in menu, select whether whether you want to search for persisted (Runtime)or archived (Archive) messages.
    • Select the maximum number of search results that the system should return.
  4. In the User-Defined Selection Criteria screen area, specify both the message part you want to find and its value as described below:

    You may choose Clear to remove all search options left from previous searches.

    • To use existing search criteria, choose Add Pre-defined in the Add menu.
      Select the interface for which you want to find messages, add defined search criteria to the Selected Criteria table as needed, and enter a value you want to find for each criterion. You can use the asterisk (*) character as wildcard when entering a value.
    • To add a search criterion directly, choose Add Custom in the Add menu.
      For each search criterion, enter the exact name of the payload part (element or attribute) and the value you want to find. You can use the asterisk (*) character as wildcard when entering a value.
    • In the Search Mode menu, choose one of the following modes:
      • If you choose to search for one value, the results depend on whether you have entered one or more pairs of search criteria and values. When there is only one search criterion and value, the system searches for all messages in which the corresponding message part has the specified value. When there are many search criteria and values entered, the system searches for all messages in which at least one of the corresponding message parts appears with one of the values you have specified.
      • If you choose to search for all values and you have entered many pairs of search criteria and values, the system searches for all messages that have all of the corresponding message parts with the specified values.
  5. Choose Search.

Result

The system performs a search and displays the messages found in the Output screen area. To see the messages found for a particular system, select it in the Message Search Overview table. The system would display the corresponding set of messages in the Message List table. In addition to a few standard message details, the system also shows columns with information for the user-defined search criteria you specified for the current search. There is a separate column for each criterion for which there is a result. In case there are no messages found for a particular criterion, or they have not been indexed, the system does not display a column for this criterion.

Consider that when the payload of a message contains more than one occurrence of a search criterion the system finds all its values. Then it displays all the values – the one that you have specified for the current search as well as the rest – in the corresponding table cell, separated with the vertical bar (|) character.

To see more detailed information about a message shown in the result list you can go to the local message monitor on the corresponding system. To do this, select the message in the Message List table and then choose the PI Message Monitor in the Navigate To menu. For more information about the how to use the local message monitor, see Monitoring Messages (Advanced Adapter Engine) and Monitoring XML Messages (Integration Engine).

When you want to notify somebody about a particular message, you can select the message in the list and choose Create > Create Notification. The system includes the most important details of the message in the notification; you can add comments as necessary. You must specify the e-mail address (or the phone number) of the receiver in the To field before sending the notification. In the same way you can create an incident ticket.

In case the search results are useful, you can save the current set of search criteria for later usage. You can do this using the following options in the Filter screen area:

The saved filter can be reused if the same search pattern is re-executed again and again over time.

 


 

Back to Central PI Monitoring with SolMan 7.1

 

Central PI Monitoring Home Page