lsfilter

Use the lsfilter command to display the threshold filter settings for all devices specified.

Syntax

Read syntax diagramSkip visual syntax diagram>>-perfcli-- --lsfilter-- --+-------------------+-- ------------>
                            '--devtype----ess---'

>--+--------------------+-- --+-----------------------+-- ------>
   '--dev--+-ID [...]-+-'     '--threshtype--diskutil-'
           '-all------'

>--+----------------+--+------------------+--------------------><
   '--filter--seqio-'  '--status--+-on--+-'
                                  '-off-'

Parameters

-devtype ess | svc
An optional parameter that specifies the device type:
  • Enterprise Storage Server (ess)
  • SAN Volume Controller (svc)
.
-dev ID [...] | all
An optional parameter that displays only the threshold filter settings for the device IDs that are specified. The Device ID is the nickname or the model-serial-manufacture of the device. Separate multiple device names with a comma in between each device with no white space before or after the comma. All devices must be of the same device type. The value all applies the threshold to all devices of the device type specified with the -devtype flag. If no device is specified, this parameter displays the threshold filter settings for all devices of the device type specified with the -devtype flag.
-threshtype diskutil
An optional parameter that filters the list to display only filters for the threshold type specified. The diskutil keyword specifies the disk utilization value (the percent of time busy), for each ESS array.
-filter seqio
An optional parameter that displays only the filter type that is specified. The seqio parameter specifies to make an exception for a sequential I/O percentage filter and its value.
-status on | off
An optional parameter that specifies whether the specified filter should be enabled or disabled for checking. The sequential I/O filter default is on and enabled for checking.

Description

You can use the lsfilter command to list all performance filters and their information for all devices or for a specific device or device type. If the device ID (a unique ID or serial number of a device) and the device type are specified, the information that is returned is a list of all filters for that specific device ID. If the device ID is null but the device type has a value such as ESS or SVC, the information that is returned is a list of filters for all devices of that device type. If both the device ID and the device type are null, the information that is returned is a list of all filters for all devices and device types.

Return values

Device ID
The device ID is the nickname or manufacturer, model, and serial number of the device.
Device type
The type of the device (ESS or SAN Volume Controller). If null, (device ID should be null too), then it returns all the filters for all the devices of all device types.
Filter name
Displays the name of the filter, for example, percent of sequential I/Os.
Threshold name
Displays threshold name, for example, disk utilization.
Value
Displays the value of the filter.
Status
Displays enabled or disabled, depending on the status of the filter.

The Percent of sequential I/Os filter is enabled by default.

Possible failures

Examples

An invocation example:

perfcli lsfilter -devtype ess -threshtype diskutil -filter seqio

The resulting output:

Device ID           Device Type  Filter Name  Threshtype  value  status
======================================================================
ESS2105-123124-IBM  ESS          Seqio        diskutil     80    Enabled   

Related topics

(C) Copyright International Business Machines Corporation 2004