QUERY command
Syntax:
QUERY items
Queries the state of various GoServe settings. 'items' is a list
of one or more keywords. The name and value of each item is displayed
using PMprintf; to see the results the PMprintf console must be active.
PMprintf should be available from the same source as GoServe, or from
the GoServe Web page at http://www2.hursley.ibm.com/goserve/
Any item that can be set by the SET command may also be queried. The
value of any item that may be set or queried may also be obtained by a
Rexx filter, using the EXTRACT command to place the values in Rexx
variables. PMprintf is not needed in order to use the EXTRACT command.
Valid items are:
-
BYTESREAD -- the number of bytes received from the network, so far
during the current transaction.
-
BYTESREADTOTAL -- the total number of bytes received from the
network. You may need to increase the Rexx NUMERIC DIGITS setting
if you wish to do arithmetic on this count. 16 digits should be
sufficient.
-
BYTESSENT -- the number of bytes sent to the network, so far during
the current transaction.
-
BYTESSENTTOTAL -- the total number of bytes sent to the network.
You may need to increase the Rexx NUMERIC DIGITS setting if you wish
to do arithmetic on this count. 16 digits should be sufficient.
-
CLIENTADDR -- the client's address used for the connection, in
numeric form (for example, 12.34.56.78). For a symbolic name for
the address, see the CLIENTNAME function.
-
CLIENTMETHOD -- the method (verb) being invoked by the client (on
the HTTP request, or "GET" if a Gopher request). For example,
"GET" or "POST".
-
CLIENTPORT -- the client's port number used for the connection.
-
CLIENTPROTOCOL -- the protocol being used by the client (on the HTTP
request, or "GOPHER" if a Gopher request). For example, "HTTP/1.0".
-
CLIENTS -- the number of clients currently connected.
-
ELAPSED -- the elapsed time, in seconds, since the current
transaction started (that is, when the network connection was
accepted). Any decimal part will not have trailing zeroes.
-
ERRORS -- the count of errors detected.
-
GMTOFFSET -- the GMT offset (in seconds). If GMTSET is OFF, this
will be 0.
-
GMTSET -- GMT is available [ON if available, else OFF].
-
LASTACCEPT -- timestamp of the last accepted connection [format:
yyyy.mm.dd hh:mm:ss].
-
LASTIDLE -- timestamp of when GoServe last entered an idle state,
with no connections [format: yyyy.mm.dd hh:mm:ss].
-
LASTRESET -- timestamp of the last CONTROL RESET ALL command
[format: yyyy.mm.dd hh:mm:ss].
-
LASTSECOND -- time now, in the same format [yyyy.mm.dd hh:mm:ss] as
the other LASTxxxx items.
-
LASTSTART -- timestamp of when this instance of GoServe was started
[format: yyyy.mm.dd hh:mm:ss].
-
LIMITS -- the count of limits exceeded (that is, the count of
transactions that were ended due to a limit being exceeded). The
limits counted are the total connection timeout (LIMITTIMETOTAL),
the incoming data measures (LIMITBODY and LIMITHEADER), and maximum
clients exceeded (LIMITCLIENTS). The latter is only counted once
for each non-idle burst of connections.
-
PEAKCLIENTS -- the maximum number of clients that were connected
simultaneously.
-
READWAITTIME -- average read wait time (seconds).
-
REQUEST -- the unique number for this HTTP request. This is
incremented as each HTTP request is read. This can differ from the
TRANSACTION (connection) number if a connection fails to send a
request, or if there is more than one request in a transaction.
-
REQUESTS -- the number of HTTP requests read since GoServe was
started, or since the last CONTROL RESET ALL or CONTROL RESET
TRANSACTIONS.
-
RESPONSEOVER -- number of connections over which RESPONSETIME and
READWAITTIME have been averaged.
-
RESPONSETIME -- average response time (seconds).
-
SELECTOR -- the selector string (Universal Resource Indicator, for
HTTP).
-
SERVERADDR -- the server's address used for the connection, in
numeric form (for example, 11.22.33.44). For a symbolic name for
the address, see the SERVERNAME function.
-
SERVERPORT -- the server's port number used for the connection (for
example, 80 for default HTTP).
-
SERVERPROTOCOL -- the protocol understood by the server (for
example, "HTTP/1.0", or "GOPHER" if running as a Gopher server).
-
SERVERSOFTWARE -- the level of the server software (for example
"GoServe/2.40"). This is the same as returned by the function call
SERVER("HTTP").
-
TRANSACTION -- the unique number for this transaction (connection).
This is incremented as each client connects to the server. This can
differ from the REQUEST number if a connection fails to send a
request, or if there is more than one request in a transaction.
Note that a filter may be called more than once during one
connection (though not concurrently).
-
TRANSACTIONS -- the number of transactions since GoServe was
started, or since the last CONTROL RESET ALL or CONTROL RESET
TRANSACTIONS.
[ previous section | contents | next section ]
From 'goserve.doc', version 2.52.
Copyright © IBM Corporation, 1993, 1998. All rights reserved.