The lsperfgrprpt command
displays a list of performance reports for the specific set of performance
groups, or all if none are specified.
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.