Configuring System Alerts for Email Notification of PIMSI Engine Synchronization Errors

You can configure SSSE so that the administrator receives email notification of errors generated by the PIMSI Engine during the inbound synchronization process, including errors relating to the Web service Exchange Connector.

To enable email notification of PIMSI Engine errors, you must create a system alert, then define the email body template to be used for error notification messages; this topic describes both of these tasks. This topic also includes an example of defining an email template for PIMSI Engine synchronization errors for the Task domain.

This task is a step in Process of Configuring Email Notification of Synchronization Errors.

To enable email notification of PIMSI Engine errors, perform the following procedure.

To configure system alerts for PIMSI Engine synchronization errors

1. Configure a system alert for the Siebel Enterprise as follows:

   1. Navigate to the Administration - Server Configuration screen, Enterprises, and then the System Alerts view.

   2. In the System Alerts list, create a new system alert, specifying values similar to the following:

      Alert Definition Name	Alias	Media
      Alertname Example: Administrator Email Alerts	Alertalias Example: AdminEmailAlert	EmailNotification

   3. In the Alert Parameters list, create the following alert parameters, and specify values for the parameters as described.

      Parameter Name	Value
      SMTPServer	SMTP server name or IP address through which the email is sent Example: mymailserver.example.com
      SMTPServerPort	Port number of the SMTP server Example: 25
      AdminEmailAddress	A comma delimited email address list of the administrators to be notified Example: [e-mail]
      FromAddress	The originating address of the email notification Example: [e-mail]
      DLLName	ssemailntfy

2. Define the email body template to be used for PIMSI Engine error notification emails as follows:

   1. Navigate to the Administration - PIM Server Integration screen, Configuration, and then the PIM Server Integration Configuration view.

   2. Select the Exchange Calendar Profile.

   3. In the Configuration Parameters list, create records with values similar to those shown in the following table.

      Note: The Domain name you specify must match an existing Domain Identifier field, for example, IPM Task. To view domain identifiers, navigate to the Administration - PIM Server Integration screen, then the PIM Domains view.

      Section	Parameter	Value
      Email Template:Domain Name	MsgBody1	Specify the body of the email with place holders. Place holders are case sensitive. The supported place holders are: %Domain%. Name of the domain is substituted. %login%. Name of the login is substituted. %ErrorMessage%. Description of the error. [Field Identifier]. Substitutes the value of the Siebel domain field identifier in the parentheses. To view the Siebel domain field identifiers, navigate to the Administration - PIM Server Integration screen, Siebel Domains, and then the Siebel Domain Fields view.
      Email Template:Domain Name	MsgBody2	This parameter allows you to add additional email body text, if required, to the supported place holders described in the previous field.

3. Set the value of the NOTIFYMSGSIZE parameter to determine the maximum size of error message notifications as follows:

   1. Log in to Server Manager using a command such as the following:

      srvrmgr /u db_user_name /p db_password /e enterprise_server /g gateway_host 
      
      /s server_name
      

   2. At the srvrmgr> prompt, enter the following command:

      change param NOTIFYMSGSIZE=nnnn for server servername
      

      where:

      • nnnn is the maximum notification size

      • servername is the server for which you are setting the NOTIFYMSGSIZE parameter

   If an error message is generated which is larger than the value of the NOTIFYMSGSIZE parameter, then the error notification email includes only the following message:

   SSSE Inbound Synch failed for User:Username,Domain:Domain 
   Please see PIMSIEng log 
   

   Therefore, if you configure large error message notifications, then increase the maximum notification size by setting the NOTIFYMSGSIZE parameter to a higher value, for example 1024.

   For an example of defining an email template for PIMSI Engine synchronization errors for the Task domain, see Example of Defining an Email Body Template for Synchronization Error Notifications.