Tcl API Reference -- ns_server

### ns_server

#### Overview

Get information about the virtual server

#### Syntax

ns_server ?-server servername? active

ns_server ?-server servername? all

ns_server ?-server servername? connections

ns_server ?-server servername? queued

ns_server ?-server servername? threads

ns_server ?-server servername? verbose ?on/off?

ns_server ?-server servername? waiting

#### Description

ns_server active returns a list of lists containing information about the currently-active connections for the specified virtual server, or the current virtual server if none is specified. For each active connection, the following information is returned:

id: | An ever-increasing number that identifies the connection.
--- | ---
peer: | The remote address.
state: | The state of the connection, one of the following: queued: waiting for a thread init: thread is initializing a connection request: reading the request authorize: authorizing the request running: running the request tcl: in a Tcl script traces: running all trace procedures
method: | The request method. If the state is before request, an asterisk "*" is shown.
url: | The request URL. If the state is before request, an asterisk "*" is shown.
time: | The number of seconds since the connection started.
bytes: | The number of bytes sent through the connection.

For example:

id | peer | state | method | url | time | bytes
--- | --- | --- | --- | --- | --- | ---
3 | 128.111.100.50 | traces | GET | /some/page.htm | 5 | 1134

ns_server all returns the same information as ns_server active about both active and waiting connections for the specified virtual server, or the current virtual server if none is specified.

ns_server connections returns the total number of connections for the specified virtual server, or the current virtual server if none is specified.

ns_server queued returns the same information as ns_server active about the waiting connections for the specified virtual server, or the current virtual server if none is specified.

ns_server threads returns a Tcl list containing the minimum number of threads, the maximum number of threads, the number of currently active threads, the number of idle threads, and the number of stopping threads for the specified virtual server, or the current virtual server if none is specified. For example:

        {min 0} {max 50} {current 2} {idle 1} {stopping 0}

ns_server verbose returns 1 if the server is in verbose mode and 0 if it is not for the specified virtual server, or the current virtual server if none is specified. If "on" is specified, sets verbose mode on. If "off" is specified, sets verbose mode off.

ns_server waiting returns the number of waiting connections for the specified virtual server, or the current virtual server if none is specified.

Top of Page
Copyright © 1998-99 America Online, Inc.