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

>>-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
- Device device does not exist.
- Device type and threshold type do not match.
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