GoServe: QUERY command

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.
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 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 timeouts, incoming data measures, and maximum clients exceeded. 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).
RESPONSEOVER -- number of connections over which RESPONSETIME and READWAITTIME have been averaged.
RESPONSETIME -- average response time (seconds).
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.20"). This is the same as returned by the function call SERVER("HTTP").
TRANSACTION -- the unique number for this transaction.

[ previous section | GoServe | next section ]