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:

All devices IDs specified must be of the same device type, and the threshold type must be available for the specified device type.

Syntax

Read syntax diagramSkip visual syntax diagram>>-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

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

Related topics

(C) Copyright International Business Machines Corporation 2004