Meta Tags

<@SERVERSTATUS>

Syntax

<@SERVERSTATUS [VALUE=value] [ENCODING=encoding] [{array attributes}]>

Description

Returns status information on Tango Server. The tag has an optional attribute, VALUE. The value of this attribute must be one of the categories specified in the following table (case insensitive).

If the value attribute is not specified, a two-column array is returned, giving all status values with the category name in the first column and the value in the second column. With this form of the tag, the ENCODING attribute, if specified, is ignored.

There are array-returning attributes that can be used to specify prefixes and suffixes for the returned array, rows within the array, and columns within the rows. They are described in the section Array-to-Text Conversion Attributes. By default, the returned array is formatted as an HTML table.

Category	Description
Version	version of status information (not the server). Tango 2000 returns "4"
ProcessID	system process ID number
UpTime	server running time (in minutes)
ActiveQryThr	number of threads marked in use
AvgQryProcTime	average time to process a request, in milliseconds, accurate to 1/60 second
LstQryProcTime	time to process last request, in milliseconds, accurate to 1/60 second
DataSrcCount	number of data source connections allocated
NumQryServed	number of requests served since server inception
MinQryProcTime	minimum request processing time so far, in milliseconds, accurate to 1/60 second
MaxQryProcTime	maximum request processing time so far, in milliseconds, accurate to 1/60 second
AvgQryReadTime	average time to read a prepare a request for processing, in milliseconds, accurate to 1/60 second
AvgQryWriteTime	average time to return results to the user after processing, in milliseconds, accurate to 1/60 second
NumAFRead	number of Tango application files read from disk, cache, or network
AvgAFReadTime	average amount of time taken to read an application file from disk, cache, or network, in milliseconds, accurate to 1/60 second
AvgAFSize	average size of application file read from disk, cache, or network
QryThrCount	number of processing threads allocated
ActiveDataSrc	number of data sources marked in use
NumQrykilled	number of requests killed (timed out) since server inception
TotlTripRdBytes	total number of bytes read via network
TotlTripRdFiles	total number of files read via network
TotlTripRdTime	total amount of time taken to read all files read via network, in milliseconds, accurate to 1/60 second
NumCachedDocs	number of application files currently in application file cache
NumCachedIncl	number of include files currently in include file cache
ProcessSize	current size of server process (bytes)
HeapSize	current amount of working memory consumed (bytes)
NumTripBadConn	number of network CGI-server connections failed
NumUsersShared	number of user references in the shared variable store
NumVarsShared	number of variables in the shared variable store
NumUsersLocal	number of user references in the local variable store
NumVarsLocal	number of variables in the local variable store
CacheBytesUsed	number of bytes used by application and include files in Tango Server's file cache. If caching is turned off, this category returns "0"
*NumQryErrors	number of requests ended by an error since Tango Server's inception
*VariableStoreSize	number of bytes used by all variables of all scopes
*MaxQryThreadCount	maximum number of threads that are in use at one time in the server
*QryStartTime	time at which a query thread was started, in milliseconds since the restart of the current operating system -- used by the Server Watcher to check whether Tango Server is running correctly
*QryLapsedTime	time elapsed since the last query was executed, in milliseconds since the restart of the current operating system -- used by the Server Watcher to check whether Tango Server is running correctly

* New in Tango 2000.

Notes

NumAFRead, AvgAFReadTime, and AvgAFSize include cache reads, and reflect the performance of the application file cache.
QryProc values may include time taken to push intermediate data back to the user.
NumQryServed includes any requests killed and tallied in NumQryKilled.
Windows and UNIX only: TripRd values measure actual network and disk accesses, and represent true overhead to read include/application files that are new, uncached, or changed since being cached.
Because of the way that Tango Server works under Macintosh, the following status values return zero under Mac OS: TotlTripRdBytes, TotlTripRdFiles, TotlTripRdTime, NumTripBadConn, and ProcessID.
Retrieving these values via the tag means executing a request, which affects the status values as specified:

A thread is used to process the request, and that bumps up the ActiveQryThr count.
Since the current request has not completed yet, the QryProcTime times and the NumQryServed count do not reflect the currently executing request.
Executing a request involves reading it, so NumAFRead and the AvgAF values reflect the current request.
If a network read was required to load the application file and other include files, the TotlTripRd values are updated.

<@SERVERSTATUS>

Syntax

Description

Category

Description

Notes

See Also