setessthresh

You can use the setessthresh command to set or change the ESS performance thresholds. To modify an existing threshold setting for a specific device, use the setessthresh command again. Only new values specified change; unspecified settings are preserved.

Syntax

Read syntax diagramSkip visual syntax diagram>>-perfcli-- --setessthresh-- ---threshtype--+-diskutil--+-- --->
                                             +-nvsfull---+
                                             +-cachehold-+
                                             +-iorate----+
                                             '-all-------'

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

>--+------------------+-- --+-----------------+-- -------------->
   '--warn--threshold-'     '--err--threshold-'

>--+------------------+-- --+----------+-- --+--------+--------><
   '--alert--+-warn-+-'     '--restore-'     '--quiet-'
             +-err--+
             '-none-'

Parameters

-threshtype diskutil | nvsfull | cachehold | iorate | all
Specifies which ESS threshold is to be set. Optionally, the diskutil threshold (ESS) includes the percentage of the sequential I/O filter when you use the setfilter command. One of the following ESS thresholds can be specified:
diskutil
The disk utilization value (percent of time busy), for each ESS array.
nvsfull
The nonvolatile storage full value (percent of time full), for each ESS cluster.
cachehold
The average cache hold time (in seconds), for each ESS cluster.
iorate
The input-output rate (total number of I/O requests), for each ESS cluster.
all
Sets all the thresholds.
-dev id [...] | all
Specifies the ESS device that will apply the threshold to be set. The device ID is the nickname or model-serial-manufacturer of the device. Multiple devices must be separated by commas. All devices must be of the same device type. When you specify all the threshold applies to all ESS devices.
-status on | off
An optional parameter that specifies whether the threshold type should be enabled or disabled for checking. For all threshold types, except the I/O rate, the default is on and enabled for checking.
-warn threshold
An optional parameter that specifies the warning threshold value. Valid ranges are 0 - 100 for all devices. The default percentage values for each warning threshold type are as follows:
  • diskutil = 50
  • nvsfull = 3
  • cachehold = 60
  • io = no default
-err threshold
An optional parameter that specifies the error threshold value. Valid ranges are 0 - 100. The default percentage values for each error threshold type are as follow:
  • diskutil = 80
  • nvsfull = 10
  • cachehold = 30
  • io = no default
-alert warn | err | none
An optional parameter that specifies which thresholds should send an alert if the threshold is exceeded. One of the following alert values can be specified:
  1. Warn. An alert is sent when the warning threshold is exceeded.
  2. Err. An alert is sent when the warning and error threshold is exceeded.
  3. None. No alerts are sent. This is the default.
    Note:Note: If the threshold status is enabled for checking, but no alerts are set to be sent, a log message is entered into the Multiple-Device Resource Manager event log, and exception information is recorded in the database.
-restore
An optional parameter that restores all default values for the specified threshold type. This argument works only on those thresholds that have default values.
-quiet
An optional parameter that turns off the confirmation prompt for this command.

Description

You can use the setessthresh command to set or change the ESS performance thresholds.

Return values

Threshold successfully set.

Possible failures

Examples

An invocation example:

perfcli setessthresh  -threshtype iorate -dev 2105.111222 -warn 60 -alert err

The resulting output:

Threshold successfully set.

Related topics

(C) Copyright International Business Machines Corporation 2004