lsthresh
You can use the
lsthresh command
to display a summary of the threshold settings for all devices that are specified.
The summary contains a list of the performance thresholds along with pertinent
information associated with the threshold including:
- The device and device type with which the threshold is associated
- The name of the performance metric for which a threshold is set
- The critical and warning threshold levels, and whether or not an alert
has been set
All devices IDs specified must be of the same device type, and the
threshold type must be available for the specified device type.
Syntax

>>-perfcli-- --lsthresh-- --+-------------------+-- ------------>
'--devtype--+-ess-+-'
'-svc-'
>--+----------------+-- ---threshtype--+-diskutil----+---------><
'--dev--id [...]-' +-nvsfull-----+
+-cachehold---+
+-iorate------+
+-vdiskbps----+
+-vdiskiorate-+
+-mdiskbps----+
'-mdiskiorate-'
Parameters
- -devtype ess | svc
- An optional parameter that specifies the device type.
- -dev id [...]
- An optional parameter that displays only the threshold settings for
the device IDs that are specified. The device ID is the nickname or manufacturer,
model and serial number of the device. Separate multiple device names with
a comma between each device, with no white space before or after the comma.
- -threshtype diskutil | nvsfull | cachehold | iorate |
vdiskbps | vdiskiorate | mdiskbps | mdiskiorate
- 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.
- vdiskbps
- The total number of virtual disk I/s for each I/O group.
- vdiskiorate
- Virtual disk megabytes per second, for each I/O group.
- mdiskbps
- Total number of managed disk I/Os for each managed disk group.
- mdiskiorate
- For each managed disk group, the megabytes per second for each I/O group.
Description
You can use the lsthresh command to display a summary
of threshold settings for all devices specified. The summary contains a list
of the performance thresholds along with pertinent information associated
with the threshold.
Return values
No threshold matched the criteria specified.
For each threshold, the following information is listed:
Column Label |
Details |
Device ID |
The nickname or manufacturer, model and serial number
of the device. |
Device Type |
Device Type: ESS. |
Threshold name |
Threshold value. Specify Diskutil. |
Status |
On or Off;
the status of the filter. |
Warning |
Displays the warning value for the threshold, if one
exists. You can enter or change the value in this cell. This value is an integer. |
Error |
Displays the error value for the threshold, if one exists.
You can enter or change the value in this cell. This value is an integer. |
Alert |
This value an be one of the following: None, Warning, or Error.
The default is None. |
The output includes a row for each device ID and threshold type that you
specify.
-
Possible failures
- Device device must be of the same device type.
- Threshold threshold type is not available for
device device_id.
Examples
An invocation example:
perfcli lsthresh -devtype ess -threshtype diskutil
The resulting output:
Device ID Device Type Threshold Name Status Warning Error Alert
==========================================================================================
ESS2105-123124-IBM ESS Disk Utilization Enabled 60.0 30.0 None
ESS2105-123125-IBM ESS Disk Utilization Enabled 60.0 30.0 None
ESS2105-123126-IBM ESS Disk Utilization Enabled 50.0 80.0 None