pw threshold

The pw threshold command can manage all of the threshold options available through the Operations Console.

Note

When using newer versions (9.6 and later) of BMC TrueSight Infrastructure Management, Integration Service, and PATROL Agents, BMC recommends that you use the TrueSight console and web services (REST APIs) to manage thresholds.

pw threshold syntax 

Usage: pw threshold set ... 
pw threshold delete ... 
pw threshold checkpoint ... 
pw threshold list \[<MonitorType> <Attribute>\]
pw threshold load \[\[-s\] <filename> \[-signature\] \[-v\]\]
pw threshold unload <filename> \[-signature\] \[-v/h\]
pw threshold \[-acv\] showType \[<MonitorType>\]
where: 
<_MonitorType_> is the name for a Monitor type 
<_Attribute_> is the name for an Attribute 
<_filename_> is the file name of the threshold. If no file name is specified then the default *<Installation Directory>/pw/pronto/sysdata/ alarmThresholds.ini* and *<Installation Directory> /pw/pronto/sysdata/signatureThresholds.ini* are used <_thresholdfilename_> is a thresholds file name. If no file path is specified then the default *<Installation Directory>/pw/tmp* is used 
options are: 
{{-signature}} (Operate on signature threshold. If not specified, will operate on absolute threshold.)
{{-a}} (Show stats attribute information) 
{{-c}} (Show input and output config attributes) 
{{-v}} (Verbose mode) 
{{-s}} (Load Safe mode. Attributes with thresholds will not be changed.) 
{{-h}} (print this help text) 
NOTE : If you see "...", type " pw <command>" for more detailed help. 
#

pw threshold set

To set a threshold for a specified monitor, attribute, and so on, run the pw threshold set command in the following format:

pw threshold set <monitor_type> <attr> <sev> <dur> <above|below|equal> <thresh> [
       -sig -mi <Monitor Instance>  -dabs <Absolute Deviation>
       -dper <Percentage Deviation>  -noac -s -sup <Suppress Sig Threshold>
       -ob <OutSideBaseLine> -bl<Baseline Type>   ]

Successful commands return the # prompt.
Example:

  • To set a global absolute threshold for the DiskSpace's Availability attribute to trigger an event when disk space usage goes above 50.5%, run the following command: 
  • pw threshold set DiskSpace Availability Major 30 Above 50.5
  • To set an absolute threshold for the DiskSpace's Availability attribute for an instance named "/tmp," run the following command:
    pw threshold set DiskSpace Availability Major 30 Above 50.5 -mi "/tmp"
  • To set a global signature threshold for DiskSpace's Availability attribute, run the following command:
    pw threshold set DiskSpace Availability Major 30 Above 0 -sig
  • To set a global absolute threshold for the Scan Rate attribute to trigger an event when scan rate is equal to 150, run the following command:

    pw threshold set "Solaris System" "Scan Rate" Minor 10 equ 150.0

Note

Prefix a % symbol for the attributes that proceed with a % symbol.

pw threshold set entries and choices

EntryChoices
<monitorType>For a complete list, which must be entered exactly and is case-sensitive, see "Example: pw threshold showtypeand attributes." Example: DiskSpace
<attr>For a complete list, which must be entered exactly and is case-sensitive, see "Example: pw threshold showtypeand attributes." Example: Availability
<sev>For absolute thresholds, the values can be either minor, major or critical. For signature thresholds, the values can be either minor, major or critical
<dur>[numeric; in minutes, between 1 and 60] Example: 30
<above|below|equal>Above [Monitor above threshold for <Duration> to trigger an event]
 Below [Monitor below threshold for <Duration> to trigger an event]
 Equal [Monitor equal threshold for <Duration> to trigger an event]
<thresh>[numeric; floating point, that is, can contain a decimal point] Example: 50.5
-mi <Monitor Instance>Name or monitor instance ID of a monitor instance. If given parameter does not match any existing monitor instances, a list are printed as part of the error message.
-sigOperates on a signature threshold. If not specified, operates on absolute thresholds.
-dabs <Absolute Deviation>Specifies the absolute buffer band
-dper <Percentage Deviation>Specifies the percentage buffer band
-noacDo not automatically close event when event condition disappears. Default is false.
-sSpecifies 'Safe Mode'. If threshold already exists, do not overwrite it.
-sup <Suppress Sig Threshold>Is a flag to indicate whether events for this threshold are to be suppressed. It can be "suppress" or "nosuppress".
-ob <OutSideBaseLine>Must be one of Hourly, Daily, Weekly, All, Auto, or Disable. By default, it is Disable.
-bl <BaseLine Type>Must be one of Hourly, Daily, Weekly, All, or Auto. Default is All.

pw threshold delete

pw threshold delete <monitor type> <attr>[ -sig -mi <Monitor Instance>

-dabs <Absolute Deviation> -dper <Percentage Deviation> -noac -dur <Threshold Duration> -above|below

-sup <Suppress Sig Threshold> -tv <Threshold Value> -sev <Severity>

This command deletes the threshold settings for the specified <MonitorType> and <Attribute>.

Format:

pw threshold delete <MonitorType> <Attribute>[Additional Qualifiers]

pw threshold delete entries and choices

EntryChoices
<monitorType>For a complete list, which must be entered exactly and is case-sensitive, see "Example: pw threshold showtypeand attributes." Example: DiskSpace
<attr>For a complete list, which must be entered exactly and is case-sensitive, see "Example: pw threshold showtypeand attributes." Example: Availability
<sev>For absolute thresholds, the values can be either minor, major or critical. For signature thresholds, the values can be either minor, major or critical
<dur>[numeric; in minutes, between 1 and 60] Example: 30
<above|below|equal>Above [Monitor above threshold for <Duration> to trigger an event]
 Below [Monitor below threshold for <Duration> to trigger an event]
 Equal [Monitor equal threshold for <Duration> to trigger an event]
<thresh>[numeric; floating point, that is, can contain a decimal point] Example: 50.5
-mi <Monitor Instance>Name or monitor instance ID of a monitor instance. If given parameter does not match any existing monitor instances, a list are printed as part of the error message.
-sigOperates on a signature threshold. If not specified, operates on absolute thresholds.
-dabs <Absolute Deviation>Specifies the absolute buffer band
-dper <Percentage Deviation>Specifies the percentage buffer band
-noacDo not automatically close event when event condition disappears. Default is false.
-sSpecifies 'Safe Mode'. If threshold already exists, do not overwrite it.
-sup <Suppress Sig Threshold>Is a flag to indicate whether events for this threshold are to be suppressed. It can be "suppress" or "nosuppress".
-ob <OutSideBaseLine>Must be one of Hourly, Daily, Weekly, All, Auto, or Disable. By default, it is Disable.
-bl <BaseLine Type>Must be one of Hourly, Daily, Weekly, All, or Auto. Default is All.

pw threshold list

This command lists all your event threshold settings. To correlate the display, review the corresponding window in the Administration Console. When using a monitor name, you must enter the name exactly.

The command must be run in the following format:

pw threshold list[<MonitorType> <Attribute>]

To view thresholds for a particular monitor, add the <monitor_name> attribute to the command. For example, to list thresholds for all system Node Ping Monitors, run the following command:

pw threshold list nodeping

Note

The pw threshold list command does not list  abnormality thresholds based on attribute defaults and will display any thresholds which are manually created.

Was this page helpful? Yes No Submitting... Thank you

Comments