setfilter

Use the setfilter command to set or change the threshold filter or exceptions.

Syntax

Read syntax diagramSkip visual syntax diagram>>-perfcli-- --setfilter-- ---devtype--ess-- ------------------->

>---threshtype--diskutil-- ---filter--seqio---limit--number----->

>-- ---dev--+-ID [...]-+-- -- --+------------------+-- --------->
            '-all------'        '--status--+-on--+-'
                                           '-off-'

>--+----------+-- ---------------------------------------------><
   '--restore-'

Parameters

-devtype ess
Specifies the device type that applies the filter. You can only specify ess.
-threshtype diskutil
Specifies the threshold type associated with the filter. The diskutil keyword specifies the disk utilization value (the percentage of time busy), for each ESS array.
-filter seqio
Specifies the filter type and its value for the associated threshold type. The seqio parameter specifies to make an exception for a sequential I/O percentage filter and its value. Valid ranges are 0 - 100. The default value is 80. The default for the seqio filter is enabled.
-limit number
Specifies a limit value for the filter. If an ESS device meets or exceeds the sequential I/O percentage filter value specified, alerts and log messages are not sent even if the disk utilization thresholds are exceeded. Valid ranges are 0 - 100. The default value is 80. The default for the seqio filter is enabled.
-dev id [...] | all
Specifies the nickname or manufacturer, model, and serial number of the device to which the filter applies. Separate multiple device names by commas. All devices must be of the same device type. The value all applies the threshold to all devices specified with the -devtype flag.
-status on | off
An optional parameter that specifies whether the specified filter should be enabled or disabled for checking. The diskutil default is on, and enabled for checking.
-restore
An optional parameter that restores all default values for the specified filter type. This parameter works only for those filters that have default values.

Description

You can use the setfilter command to set or change the threshold filter or exceptions.

Return values

Filter successfully set.

Possible failures

Examples

An invocation example:

perfcli> setfilter -devtype ess -threshtype diskutil -filter seqio -limit 80 -dev 2105.28019

The resulting output:

Filter successfully set.

Related topics

(C) Copyright International Business Machines Corporation 2004