Draft for Information Only

Content


        ASP Server Components
 
                  Status Component
   
        File Name
   
                  Syntax
   
                Parameters
   
                  Remark
  
            Status Properties
   
            Syntax
   
            Parameters
   
            Return Values
  
            Status Properties Examples

ASP Server Components

Some of the ASP server components are the common features found in dynamic web pages. These base ASP server components are provided to enrich the pre-made functions of ASP technology for making dynamic and interactive web pages. However, some IIS pre-made components are not installed for all version of IIS. Ad Rotator, Browser Capabilities, Content Linker, Content Rotator, Counters, Logging Utility, My Info, Page Counter, Status, and tools are not installed with IIS 6.0. However, if you upgrade your Web server from a previous version of IIS, the pre-made components are not removed. Some IIS pre-made components, ASP content rotator and nextlink, are deprecated in IIS7. And most IIS pre-made components are either not installed with IIS7 or their usage is not supported.

Status Component

The Status component can be used to create a Status object that acts as a HTML tags holder that containg the server status information on an ASP page. However for all Windows platforms, the properties of the Status object currently all return the string "unavailable". The only need for the Status object is when runnig the ASP scripts that were developed on Macintosh and properties of the the Server status are used.

File Name

The file name of the Status component is Status.dll.

Syntax

Set StatusName = Server.CreateObject("MSWC.Status")

Parameters

StatusName

The parameter "StatusName" is the name assigned to the instance of the Status object created by the call using the Server.CreateObject.

Remark

The Status component does not work with Internet Information Server 7 (IIS7).

Status Properties

The properties of a Status object is used as the item fields of the Status object to retrieve the information from the server.

Syntax

StatusName. PropertyName

var=StatusName. PropertyName

Parameters

StatusName

The parameter "StatusName" is the name of the instance of the Status object to be return.

PropertyName

The parameter "PropertyName" is the name of the property of the Status object instance to be return.

var

The parameter "var" is the variable name assigned to.

Return Values

For all Windows platforms, the properties of the Status object currently all return the string "unavailable". The Status properties are implemented on Macintosh Only.

Status Properties Examples

IThe Status properties implemented on Macintosh are

Value	Description
Status.VisitorsSinceStart	to return the number of unique visitors (IP addresses or domain names) since the server started up.
Status.RequestsSinceStart	to return the number of requests since the server started up.
Status.ActiveHTTPSessions	to return the current number of HTTP connections.
Status.HighHTTPSessions	to return the highest number of concurrent HTTP connections since the server started up.
Status.ServerVersion	to return the Personal Web Server version string.
Status.StartTime	to return the time the server started up.
Status.StartDate	to return the date the server started up.
Status.FreeMem	to return the amount of unused memory available to the server.
Status.FreeLowMem	to return the lowest value for the amount of unused memory available to the server since it started up.
Status.VisitorsToday	to return the number of unique visitors (IP addresses or domain names) since midnight.
Status.RequestsToday	to return the number of requests since midnight.
Status.BusyConnections	to return the total number of requests that were rejected because the server was already handling the maximum number of connections it can handle.
Status.RefusedConnections	to return the total number of requests that were refused because the authentication was invalid.
Status.TimedoutConnections	to return the total number of connections that were closed without a request having been received.
Status.Ktransferred	to return the total number of kilobytes sent by the server since the server started up.
Status.TotalRequests	to return the total number of requests received since the status counters were reset using the admin tool.
Status.CurrentThreads	to return the sum of the number active http connections and the number of threads in the connection thread pool that are not currently handling connections.
Status.AvailableThreads	to return the number of threads in the connection thread pool that are not currently handling connections.
Status.RecentVisitors	to return an HTML table listing the 32 most recent unique visitors. This table includes each visitor's domain name (or IP address if the domain name is not available) and the number of requests generated by each visitor.
Status.PopularPages	to return an HTML table listing the 32 most recently visited pages. This table includes each page's URL and the number of requests for each page.

©sideway

ID: 130300002 Last Updated: 3/5/2013 Revision: 0 Ref:

References

Active Server Pages, , http://msdn.microsoft.com/en-us/library/aa286483.aspx
ASP Overview, , http://msdn.microsoft.com/en-us/library/ms524929%28v=vs.90%29.aspx
ASP Best Practices, , http://technet.microsoft.com/en-us/library/cc939157.aspx
ASP Built-in Objects, , http://msdn.microsoft.com/en-us/library/ie/ms524716(v=vs.90).aspx
Response Object, , http://msdn.microsoft.com/en-us/library/ms525405(v=vs.90).aspx
Request Object, , http://msdn.microsoft.com/en-us/library/ms524948(v=vs.90).aspx
Server Object (IIS), , http://msdn.microsoft.com/en-us/library/ms525541(v=vs.90).aspx
Application Object (IIS), , http://msdn.microsoft.com/en-us/library/ms525360(v=vs.90).aspx
Session Object (IIS), , http://msdn.microsoft.com/en-us/library/ms524319(8v=vs.90).aspx
ASPError Object, , http://msdn.microsoft.com/en-us/library/ms524942(v=vs.90).aspx
ObjectContext Object (IIS), , http://msdn.microsoft.com/en-us/library/ms525667(v=vs.90).aspx
Debugging Global.asa Files, , http://msdn.microsoft.com/en-us/library/aa291249(v=vs.71).aspx
How to: Debug Global.asa files, , http://msdn.microsoft.com/en-us/library/ms241868(v=vs.80).aspx
Calling COM Components from ASP Pages, , http://msdn.microsoft.com/en-us/library/ms524620(v=VS.90).aspx
IIS ASP Scripting Reference, , http://msdn.microsoft.com/en-us/library/ms524664(v=vs.90).aspx
ASP Keywords, , http://msdn.microsoft.com/en-us/library/ms524672(v=vs.90).aspx
Creating Simple ASP Pages, , http://msdn.microsoft.com/en-us/library/ms524741(v=vs.90).aspx
Including Files in ASP Applications, , http://msdn.microsoft.com/en-us/library/ms524876(v=vs.90).aspx
ASP Overview, , http://msdn.microsoft.com/en-us/library/ms524929(v=vs.90).aspx
FileSystemObject Object, , http://msdn.microsoft.com/en-us/library/z9ty6h50(v=vs.84).aspx
http://msdn.microsoft.com/en-us/library/windows/desktop/ms675944(v=vs.85).aspx, , ADO Object Model
ADO Fundamentals, , http://msdn.microsoft.com/en-us/library/windows/desktop/ms680928(v=vs.85).aspx