Important This documentation space contains information about PATROL Agents when deployed in a TrueSight Operations Management environment. If you are a BMC Helix Operations Management user, see PATROL Agent for BMC Helix Operations Management 24.3.01.

Setting parameters alarms


This section describes how to set a parameter alarm using the PATROL Developer Console for Windows and UNIX. 

Parameter alarm properties

The following table describes the alarm properties of a parameter.

Parameter alarm properties

If you enable the Alarm1 range, you can specify a recovery action and other properties on the Alarm1 Actions tab.

If you enable the Alarm2 range, you can specify a recovery action and other properties on the Alarm2 Actions tab|

Setting parameter alarms on Windows

In this task, you will set alarm ranges for a parameter.

To  set parameter alarms on Windows

  1. Click the Alarm Ranges tab on the Parameter Properties dialog box for the appropriate parameter as shown in the following figure. 

    Parameter Properties dialog, Alarm Ranges tab
    devbasic3310-86.gif
  2. Choose the appropriate options that appear on the Alarm Ranges tab. Parameter alarm properties summarizes the available options. When the Border, Alarm1, or Alarm2 ranges are enabled, an action tab is created for the range on the Parameters Properties dialog box.
  3. Click Apply to save the changes to the PATROL KM.

Setting parameter alarms on UNIX

In this task, you will set alarm ranges for a parameter.

To  set up parameter alarms on UNIX

  1. Choose Edit > Modify from the appropriate List of Parameters window menu bar to change the selected parameter.
    A Parameter Definition dialog box appears, similar to the one shown in Parameter Definition dialog box, General. The Alarm Ranges button appears as in the following figure. 

    Parameter Definition dialog box, Alarm Ranges 

    parameter_definition_dialog_alarm_ranges.gif
  2. Click the Alarm Ranges button to access the List of Ranges window for the selected parameter.
    The List of Ranges window appears as shown in the following figure. 

    List of Ranges window 

    list_of_ranges_window.gif

    The List Of Ranges window has three entries that are described in Parameter alarm properties,
  3. Choose Options > Range Limits from the List Of Ranges window Options menu to edit the alert scale values. The Alert Scale Values dialog box appears as shown in the following figure. 

    Alert Scale Values dialog box 
    alert_scale_values_dialog_box.gif
    Set unit scaling by one of the following methods:
    • Dynamically - To scale the parameter display using the parameter's actual maximum and minimum values, click the Automatically Scale Output check box.
    • Statically - To set scale directly, type values in the Minimum and Maximum entry fields that bracket the entire spectrum of possible parameter values. The range limits that you define controls the maximum and minimum values possible for the Border, Alarm1, and Alarm2 dialog box. For further information on the values you enter, see Parameter alarm properties.
  4. Click OK to apply the changes and return to the List of Ranges window. If it is possible for a parameter to have extreme values that lie near the range limits, use the Border option to define the range of values that a parameter might have under abnormal conditions.
    If you enable the border range, you can assign a state to the range, set an alarm, and set up border recovery actions on the Border dialog box.

To define the border alarm

  1. Double-click the Border item in the List of Ranges window. Alternatively, select the Border item and choose Edit > Modify from the menu bar.
    The Border Of dialog box appears as shown in the following figure. 

    Border dialog box 

    border_dialog_box.gif
  2. Choose or modify the appropriate options that appear on the Border dialog box. Parameter alarm properties summarizes the available options.
  3. Click OK to apply the changes and return to the List of Ranges window.

To define Alarm1 or Alarm2

  1. Double-click the appropriate option, either Alarm1 or Alarm2, in the List of Ranges window, and select Edit => Modify from the List of Ranges window menu bar.
    The alarm definition dialog box is displayed as shown in the following figure.

    Note

    Often, it is often helpful to display the definition windows for Alarm1 and Alarm2 simultaneously.

    Alarm1 dialog box

    alarm1_dialog_box.gif

  2. Choose or modify the appropriate options that appear on the alarm definition dialog box.
  3. Click OK to apply the changes and return to the List of Ranges window.

KM output-parameter alarm ranges

The following figure shows sample output created by the PATROL Developer Console when you schedule a parameter. 

KM output-application class parameter alarm ranges 

devbasic3310-95.gif

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*