Show TOC

Configuring a Local Consumer on AS JavaLocate this document in the navigation structure

Prerequisites

  • Make sure the alert rules for which you need to configure e-mail notification meet all of the following requirements:

    • The alert consumer is ALERT-TO-MAIL.

    • The alert rule applies to the runtime component on which you want to run the local alert consumer.

    • The alert rule is enabled and activated.

    For more information, see Modifying Rules .

  • Your user account in the system where you want to configure the local alert consumer allows you to schedule jobs in this system.

  • You have configured properly the AS Java system to send e-mail. For more information, see Configuring the JavaMail Client Service .

Context

By setting an alert rule to use a local alert consumer and scheduling a dedicated background job you can configure a simple notification mechanism. Using this mechanism, the system would generate notifications upon message alert events, and would send these notifications via e-mail or SMS to users who should receive them.

Consider the following about the local alert consumer described here:

  • It applies only to the system in which you configure it. This can be any AS Java system where component-based message alerting is activated and an Alert Engine is running.

  • It provides only a basic set of features. In situations where you need an extended set of features you should use the alert consumer provided with SAP Solution Manager, or you can implement your own alert consumer.

Procedure

  1. Open a browser and go to http://[host]:[port]/nwa to access SAP NetWeaver Administrator on the system where you want to configure the local alert consumer.
  2. Choose Start of the navigation path Operations Next navigation step Jobs Next navigation step Java Scheduler Next navigation step Job Definitions End of the navigation path, and make sure the AlertConsumerJob job is present.
  3. Choose the Tasks tab and then choose the Add button to create a new task.
  4. Select the AlertConsumerJob job and enter a name, description, and retention period for the task.
  5. In the Set Properties step, enter the following information:

    • In the MailTo field, enter the addresses (separated by a comma) of all users who should receive notifications.

    • In the MailFrom field, enter the address of the user who should appear as the sender in the notifications.

    • In the AlertToMailLimit field, enter the number of individual message details that would be included in the e-mail notification. The default value is 20.

    • In the Consumer field, enter the name of the local alert consumer specified for the alert rules. The default is ALERT-TO-MAIL.

  6. Set the task execution time.

    For a recurring task, the recommended period is 5 minutes.

  7. Choose Finish to save the task.

Results

When the system detects issues for which alert rules are defined, it creates alerts. The job you configured would generate collective notifications for each unique combination of alert rule, runtime component, integration flow, and error label. Then the job would send notifications via e-mail or SMS to the users you specified above. For each message listed in the notification, the users can find the following information:

  • The corresponding alert rule, the ID of the message, the type of error, as well as other parameters of the message header.

  • The URL for accessing information about the message in the message monitor.

After starting the notification mechanism, you can manage it in the following ways:

  • Choose the Jobs tab to view the status of the execution of the job, log messages for the job, and other useful information in the Job Details screen area.

  • If you want to hold or remove the background job, you can do this on the Tasks tab.

Next Steps

Creating a Scheduler Task