Configure the SMPP Device Engine

The first step in implementing the automatic Device deactivation feature is to configure the SMPP Device Engine to accept service provider status reports and to recognize the status reports that indicate a delisted or deactivated Device.

To configure the SMPP Device Engine:
  1. Log in to the xMatters web user interface as a Super Administrator, and in the Configuration menu, click Nodes and Device Engines.
  2. On the Nodes page, in the View Components column of the All Nodes table, click Device Engines.
  3. Do one of the following:
    1. To configure an existing SMPP Device Engine, click its name in the Device Engines table.
    2. To configure a new SMPP Device Engine, click the Add New link above the All Components table. In the drop-down list, select SMPP Device Engine, and then click Continue.
  4. On the SMPP Device Engine details page, ensure that the Support Status Report check box is selected.
    1. This feature relies on the status reports to determine when a Device has been delisted by a service provider; if this option is not selected, you will not be able to use the automatic Device deactivation feature.
  1. In the Error Code Location or Delimiter field, specify how the Device Engine should parse an incoming status report to identify an error code.
    1. For example, the default setting is err: (3). Using this setting, xMatters will inspect an incoming status report for a portion of the message that begins with "err:", and then use the three characters that follow as the error code; e.g., a message containing the phrase "err: 023" would translate as the error code "023".
  2. In the Failed Words field, specify the status string value that can be found within the incoming status report and indicate the notification message has failed due to a delisted Device. (Use a semi-colon to separate multiple values.)
    1. Note that this status is identified using the Status Location or Delimiter field in the same way as the error codes in the previous step. The default of stat: (7) inspects the status report for the phrase "stat:", and then compares the seven characters that follow with the list of failed words.
  3. Click Save.