lscounters

Use the lscounters command to list available performance counters.

Syntax

Read syntax diagramSkip visual syntax diagramtpctoollscounters-user user_name -pwd password -url url -fabric WWN-subsyssubsystem -ctype comp_type levelsamplehourlydaily -fs character-header -help-qs character?-silent

Parameters and arguments

-user user_name
Specifies an IBM Spectrum Control user ID.
-pwd password
Specifies the password for the IBM Spectrum Control user ID.
-url url
Specifies the Device server. The format of the URL is system:port_number, where system represents either the host name or IP address, and port_number represents the IBM Spectrum Control Device server port.
-fabric WWN
Specifies the fabric. The WWN variable is the worldwide name (WWN).
-subsys subsystem
Specifies the storage subsystem. The subsystem variable is the GUID of the storage subsystem. You can use the lsdev command to return information, including the GUID, for all storage subsystems that are discovered by IBM Spectrum Control.
-ctype comp_type
Specifies that the output is to include only components of the specified type. For more information about the comp_type variable, see the lstype command.
-level sample | hourly | daily
Specifies the level for which the performance counters are to be summarized. You can specify a sample summary, an hourly summary, or a daily summary.
-fs character
Specifies the 7-bit character that separates the information in the output. If you omit this parameter, the information is separated by blank spaces.
-header
Suppresses the column headings in the output. If you omit this parameter, the column headings are included.
-help | -h | -?
Lists help information for the command.
-qs character
Specifies the 7-bit character that surrounds character strings and date stamps in the output. If you omit this parameter, character strings and date stamps are enclosed by double quotation marks (").
-silent
Suppresses all output for the command. If you omit this parameter, output is included.

Example: Listing performance counters

The following command generates a list of performance counters for volumes on the specified storage subsystem:
tpctool> lscounters -user me -pwd mypass -url myhost:myport 
-subsys 2105.22232+0 -ctype vol -level sample
The following output is returned.
Counter                                Value
============================================
Read I/O Count (normal)                1
Read I/O Count (sequential)            2
Write I/O Count (normal)               4
Write I/O Count (sequential)           5
Read Cache Hit Count (normal)          10
Read Cache Hit Count (sequential)      11
Write Cache Hit Count (normal)         13
Write Cache Hit Count (sequential)     14
Read Data Count                        22
Write Data Count                       23
Read Service Periods                   28
Write Service Periods                  29
Disk to Cache Transfers (normal)       31
Disk to Cache Transfers (sequential)   32
Cache to Disk Transfers                33
NVS Allocation Count                   34
DFW I/O Count (normal)                 35
DFW I/O Count (sequential)             36
NVS Delayed I/O Count                  37
Cache Delayed I/O Count                38
Record-Mode-Read I/O Count             39
Record-Mode-Read Cache Hit Count       40
Quick Write Promote Count              41