lsperfgrprpt

The lsperfgrprpt command displays a list of performance reports for the specific set of performance groups, or all if none are specified.

Read syntax diagramSkip visual syntax diagramlsperfgrprpt  -dev storage_image_ID  -s  -l  -dapair  dapair_ID  -rank  rank_ID  -start  time  -stop  time  -interval  time  performance_group_ID   "-"

Parameters

-dev storage_image_ID
(Optional) Displays the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify fully qualified IDs. It is also required if you do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command.
-s
(Optional) Use this parameter to display only the performance group IDs. You cannot use the -s and the -l parameters together.
-l
(Optional) Use this parameter to display the default output and extra attributes that are identified as long output. You cannot use the -s and the -l parameters together.
-dapair dapair_ID
(Optional) Displays only the performance groups with the specified DA pair ID. You cannot use the -dapair and the -rank parameters together.
-rank rank_ID
(Optional) Displays only the performance groups with the specified rank ID. You cannot use the -dapair and the -rank parameters together.
-start time
(Optional) Specifies the start time of the report in the past, relative to the current time. The time format is specified in days, hours, minutes; for example: 1d,2h,3m. The default is 1h, which means 1 hour before the current time.
-stop time
(Optional) Specifies the stop time of the report in the past, relative to the current time. The time format is specified in days, hours, minutes. The default is 0m, which means the current time.
-interval time
(Optional) Specifies the interval of time between report samples. The time format is specified in days, hours, minutes. The default is 5m, which means a 5-minute interval between samples.
performance_group_ID |
(Optional) Displays only the performance groups with the performance group IDs specified. Multiple IDs or ID ranges must be separated with a white space between each value. If you use the dash (-), the specified value is read from standard input.
Note: Each line of the display is defined as a "report" for that resource at that time. This command has a maximum limit of 256 reports, but is configurable in the dscli.profile. If the limit is exceeded, the command displays an error message and the limit number of reports. The truncated reports are not always at the end of the displayed reports, but might appear as missing reports within the range of the displayed reports.

Example

Invoking the lsperfgrprpt command
dscli> lsperfgrprpt
The resulting output
Date/Time grp resrc avIO avMB avresp pri
2009-05-20/15:23:19 PG50 IBM.2107-75FA120 123465 1.234 12.345 12
aveQ tgtQ %hlpT %dlyT %impT mnIO mxIO %idle mnMB mxMB
123 123 100 100 100 123456 123456 100 1.234 1.234
mnresp mxresp %Hutl %VHutl %loQ %hiQ %hlp# %rep %dly# %ceil
123.450 123.450 100 100 100 100 100 100 100 1234

Report field definitions

Date/Time
Indicates the time stamp for the performance group statistics.
grp
Indicates the performance group ID.
resrc
Indicates the resource ID for the specified resource.
avIO
Indicates the average (mean) I/O operation per second.
avMB
Indicates the average (mean) megabytes per second transferred.
avresp
Indicates the average (mean) response time in milliseconds (ms) for track I/O operations during this interval.
pri
Indicates the performance group priority.
avQ
Indicates the average (mean) I/O-weighted QoS index during this interval.
tgtQ
Indicates the QoS target value for the performance group.
%hlpT
Indicates the percent of intervals in which I/Os were helped.
%dlyT
Indicates the percent of time in which I/Os were delayed.
%impt
Indicates the percentage of impact on those I/Os delayed.
mnIO
Indicates the minimum track I/O operation per second.
mxIO
Indicates the maximum track I/O operation per second.
%idle
Indicates the percentage idle.
mnMB
Indicates the minimum megabytes per second transferred.
mxMB
Indicates the maximum megabytes per second transferred.
mnresp
Indicates the minimum response time for track I/O operations during this interval.
mxresp
Indicates the maximum response time for track I/O operations during this interval.
%Hutl
Indicates the percentage of time in which the specified resource had utilization high enough to warrant workload control.
%VHutl
Indicates the percentage of time in which the specified resource had very high utilization.
%loQ
Indicates the interval percentage with low QoS.
%hiQ
Indicates the time percentage with high QoS.
%hlp#
Indicates the percent of I/Os which were helped.
%req
Indicates the percentage of time in which I/O help was requested.
%dly#
Indicates the percentage of I/Os delayed by throttling.
%ceil
Indicates the ceiling for performance group on acceptable impact.