gp_utl

Display a table of test cell utilization data.

Enter:

gp_utl <cell> [interval] [periods] [month] [day] [year] [+reverse]

Where:

cell	Specify the test cell number.
interval	Optional. Specify one of the following time interval report options: day => daily [default] week => weekly month => monthly year => yearly
periods	Optional. Specify the number of periods of [ interval ] to display. The default is all periods.
month	Optional. Specify the display month. Valid entries are 1 to 12 Jan to Dec. The default is month 1.
day	Optional. Specify the display day of month. Valid entries are 1 to 31. The default is day 1.
year	Optional. Specify the display year since 2000. The default is 00.
+reverse	Specify this flag to display results in reverse chronological order.

Example:

gp_utl cell=100
The above displays all utilization data for cell 100 by day.

gp_utl cell=100 +r
The above displays all utilization data for cell 100 by day in reverse chronological order.

gp_utl cell=100 month=Mar n=7
The above displays all utilization data for cell 100 for first 7 days of March.

gp_utl cell=100 month=Mar interval=week
The above displays utilization data for cell 100 by week for March.

Notes:

The month/day/year specifications only indicate the start or end of the report. It would indicate the starting point for the report. Use the [ n=periods ] option to limit the length of the report. For instance, a month long report starting in January would be specified with month=Jan n=31.

The gp_utl command displays a tabular report of test cell utilization for the specified interval in the following format:

start-date interval hours

Data is retrieved from cell meter data files collected for all test cells. One line is displayed for each time unit in (interval).

If none of the interval arguments is used, then the start-date is the first date in the data file (or last date for +reverse).

See Also: