lsperfrescrpt

The lsperfrescrpt command displays a list of performance reports for a given resource or set of resources of a given type.

Read syntax diagramSkip visual syntax diagramlsperfrescrpt  -dev storage_image_ID  -s  -l  -start  time  -stop  time  -interval  time dapair_idrank_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, 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 will temporarily override 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 additional attributes that are identified as long output. You cannot use the -s and the -l 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 one 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 five-minutes interval between samples.
dapair_id | rank_id |
(Optional) The specified resource for which performance reports should be displayed.
A device adapter pair ID (dapair_id) is a decimal number prefixed by the letters DP. A rank number (rank_id) is a decimal number prefixed by the letter R.
If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. If specifying a resource, only one resource may be specified.
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 lsperfrescrpt command
dscli> lsperfrescrpt DP2
The resulting output


Date/Time resrc avIO avMB avresp %Hutl %hlpT %dlyT %impT
2009-05-20/15:23:19 IBM.2107-75FA120 555 2.046 1.477 0 13 0 212

Report field definitions

Date/Time
Indicates the time stamp for the performance group statistics.
resrc
Indicates the resource ID for the specified resource.
avIO
Indicates the average (mean) IO operation per second.
avMB
Indicates the average (mean) megabytes per second transferred.
avresp
Indicates the average (mean) response time in tenths of a second for track IO operations during this interval.
%Hutl
Indicates the percentage of time in which the specified resource had utilization high enough to warrant workload control.
%hlpT
Indicates the percent of intervals in which IOs were helped.
%dlyT
Indicates the percent of time in which IOs were delayed.
%impt
Indicates the percentage of impact on those I/Os delayed.