Meta Tags

<@SERVERSTATUS>

Syntax

<@SERVERSTATUS [VALUE=value][ENCODING=encoding]>

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

Category	Description
Version	version of status information (not the server)
ProcessID	system process ID number
UpTime (min)	server running time (in minutes)
ActiveQryThr	number of threads marked in use
AvgQryProcTime	average time to process a request, in 1/60 second ticks
LstQryProcTime	time to process last request, in 1/60 second ticks
DataSrcCount	number of data source connections allocated
NumQryServed	number of requests served since server inception
MinQryProcTime	minimum request processing time so far, in 1/60 second ticks
MaxQryProcTime	maximum request processing time so far, in 1/60 second ticks
AvgQryReadTime	average time to read a prepare a request for processing, in 1/60 second ticks
AvgQryWriteTime	average time to return results to the user after processing, in 1/60 second ticks
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 1/60 second ticks
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 1/60 second ticks
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

Notes

NumAFRead, AvgAFReadTime, and AvgAFSize include cache reads, and therefore 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 Unix

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.

Mac OS

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