com.esri.arcgis.server
Interface IServerTimeRange

All Superinterfaces:

Serializable

All Known Implementing Classes:

IServerTimeRangeProxy, ServerStatisticsArray, ServerStatisticsResults

public interface IServerTimeRange
extends Serializable

Provides access to members that report the actual time range for GIS server statistics reported by IServerStatstics to administrators.

Remarks

The IServerTimeRange is used to get a report of the actual time period that the results of a statistics query on the GIS server reflects.

As the GIS server creates and destroys server objects, handles client requests and so on, statistics about these events are logged in the GIS server's logs. In addition to the log, statistics are also kept in memory and can be queried using the IServerStatistcs interface. The IServerStatistics interface is a supported interface on ServerObjectAdmin.

While the GIS server's logs maintain a record of all events in the server, the set of statistics that are in memory and that can be queried are accumulated summaries of time slices since the GIS server was started. The granularity of these time slices is more coarse the futher back in time you go. These statistics can be queried for the following time intervals:

• By second for the current minute
• By minute for the current hour
• By hour for the current day
• By day for events that happened previous to the current day

Each time period is an accumulated total of the statistics for that time period. For example, if you query for the total number of request to create server contexts for the last 30 days, you would get statistics from now to the begning of the day 30 days ago (not to the current time on that day). This is because the in memory statistcs have been combined for that entire day.

This means that you may actually get statistics for a longer period that you speficied in your query. When you query the GIS server for statistics, you can use the IServerTimeRange interface to get a report of the actual time period that your queries results reflect.

The StartTime property indicates the start of the time period that the server statistics represent.

The EndTime property indicates the end of the time period that the server statistics represent.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Method Summary

Date	getEndTime() The end time for the period that the statistics represent.
Date	getStartTime() The start time for the period that the statistics represent.

Method Detail

getStartTime

Date getStartTime()
                  throws IOException,
                         AutomationException

The start time for the period that the statistics represent.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Returns:

The pTime

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getEndTime

Date getEndTime()
                throws IOException,
                       AutomationException

The end time for the period that the statistics represent.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Returns:

The pTime

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.