gp_utl

Purpose:

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

Specify one of the following time interval report options:

  • day => daily [default]
  • week => weekly
  • month => monthly
  • year => yearly

periods

Specify the number of periods of [ interval ] to display.
The default is all periods.

month

Specify The display month. Valid entries are 1 to 12 Jan to Dec

day

Specify the display day of month. Valid entries are 1 to 31.

year

Specify the display year since 2000.

+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: