tracklun

Use the tracklun command to report historical performance statistics that are necessary to create a workload profile. The profile is created on specified ESS volumes based on a specified activity period.

Optionally, you can choose to save the historical statistics as a performance workload profile to be used with a mkrecom command.

Syntax

Read syntax diagramSkip visual syntax diagram>>-perfcli-- --tracklun-- ---starttime--new_starttime----------->

>---endtime--new_endtime---startdate--new_startdate------------->

>---enddate--new_enddate-- --+-----------------------+-- ------->
                             '--timemode--+-client-+-'
                                          +-server-+
                                          +-device-+
                                          '-gmt----'

>--+---------------------+--+----------------------+-- --------->
   '--save--profile_name-'  '--desc--"description"-'

>--LUNs--+-[...]-+---------------------------------------------><
         '-------'

Parameters

-starttime new_starttime
The time, in HH:MM format, of the start peak duration.
-endtime endtime
The time, in HH:MM format, of the end peak duration.
-startdate startdate
The date, in yyyymmdd format, when the profile should start.
-enddate enddate
The date, in yyyymmdd format, when the profile should end.
-timemode client | server | device | gmt
An optional parameter that indicates how the starttime, endtime, startdate, and enddate parameters are interpreted in terms of time zone.
client
Dates and times are specified in the time zone of the client.
server
Dates and times are specified in the time zone of the server.
device
Dates and times are specified in the time zone of the device.
gmt
Dates and times are specified in the time zone of the server expressed as Greenwich Mean Time (GMT).
-save profile_name
An optional parameter that saves the performance data as a performance workload profile that can be used at a later time with the mkrecom command.
-desc "description"
An optional parameter that specifies a description for the profile when the -save parameter is used.
LUNs [...] | -
Specifies the ESS volumes to track. All LUNs must be the same device type. Separate each volume with a white space. Alternatively, use the dash (-) to specify that input for this parameter comes from an input stream (stdin).

Description

You can use the tracklun command to report historical performance statistics necessary to create a workload profile on specified ESS volumes based on a specified activity period. Optionally, you can choose to save the historical statistics as a performance workload profile to be used with a mkrecom command.

Return values

Profile profile_name is successfully created (if the -save parameter was specified).

Possible failures

Examples

An invocation example:

perfcli> tracklun -startime 12:00 -endtime 13:00 -startdate 20040101 -enddate 20040101
 ESS:2105.65302:VOL:1610 -save myprofile2

The resulting output:

Profile myprofile2 successfully created.

In this example, the client is in the EST time zone, the server is in the PST time zone, device A is in PST, device B in is CST, the starttime is specified as 13:00, and the endtime is specified as 14:00. The timemode values are interpreted as:

client
The server will query the server database for device A and device B data with server timestamps between 10:00 and 11:00, three hours earlier than specified.
device
The server will query the database for device A and device B data with device timestamps between 13:00 and 14:00.
server
The server will query the database for device A and device B data with server timestamps between 13:00 and 14:00.
gmt
Since PST is (GMT - 8), the server will query for device A and device B data with server timestamps between 05:00 and 06:00.

Related topics

(C) Copyright International Business Machines Corporation 2004