GoServe: SET command

SET command

Syntax:

  SET item newvalue

Changes the state of various GoServe settings. 'item' is one of the listed keywords. The value of any item that can be set by the SET command can also be queried using the QUERY command, or obtained by a Rexx filter using the EXTRACT command.

Flags (items that are either ON or OFF) can also be set to INVERT, which changes the state of the flag from ON to OFF or vice versa.

Valid items are:

AUDITACCEPT -- Audit accepted connections [ON/OFF]. See "The audit mechanism" for more details on this and the other audit settings.
AUDITCOMPLETE -- Audit completed connections [ON/OFF].
AUDITERROR -- Audit errors (for example, in commands) [ON/OFF].
AUDITFAIL -- Audit errors that stop the server [ON/OFF].
AUDITGMT -- Use GMT in the audit file [ON/OFF]. This may only be set ON if GMT is available (that is, GMTSET is ON).
AUDITINFO -- Audit informational lines, such as statistics [ON/OFF].
AUDITLIMIT -- Audit limits lines, when transactions are halted due to a timeout, an incoming data limit exceeded, or maxmium clients exceeded. The latter is only audited once for each non-idle burst of connections [ON/OFF].
AUDITSELECT -- Audit selectors (this is the request string, as is passed as the second argument to the filter) [ON/OFF].
AUDITUSER -- Audit user audit lines, from the AUDIT command [ON/OFF].
DATADIR -- data directory name (path). This must be a path (including a drive specification) that refers to an existing directory. When changed, this takes effect immediately; that is, subsequent calls to the DATADIR function (or the use of QUERY DATADIR or EXTRACT DATADIR) in this and other transactions will return the new directory information.
DIAG -- diagnostic tracing [ON/OFF].
DIAG2 -- verbose diagnostic tracing [ON/OFF].
DIAGMSG -- diagnostic PM message tracing [ON/OFF].
FASTFILE -- file command cache enable [ON/OFF]. When ON, the file command cache is active (see "File command cache").
FASTFILTER -- file command cache filter control [ON/OFF]. When ON, the GoServe filter will be called even if a cached FILE command was used (see "File command cache").
FILTER -- the name of the Rexx filter. This must be a filename with no path referring to a file in the GoServe working directory; a default extension of PORT will be added if needed. When changed, the new filter will be used for subsequent transactions.
HIDDEN -- main window state [ON/OFF]. If HIDDEN is changed from OFF to ON, the GoServe main window is minimized. If changed from ON to OFF, the main window is restored and surfaced.
LIMITBODY -- maximum size (in thousands of bytes) of body data that will be accepted [0 through 1E+6].
LIMITCLIENTS -- maximum number of client connections allowed concurrently [1 through 1E+6].
LIMITFILES -- maximum number of open files allowed, per client connection [1 through 100].
LIMITHEADER -- maximum size (in thousands of bytes) of header data that will be accepted [1 through 1E+6].
LIMITSTARTWAIT -- maximum time, in seconds, for which GoServe will wait on startup for TCP/IP to become operational, while retrying appropriate TCP/IP calls as necessary [0 through 1E+9].
LIMITTIMEINACTIVE -- maximum time, in seconds, for which GoServe will allow a client to remain connected but inactive (that is, without sending or reading data) [0 through LIMITTIMETOTAL].
LIMITTIMETOTAL -- maximum time, in seconds, for which GoServe will allow a client to remain connected, even if active [LIMITTIMEINACTIVE through 1E+9].
LIMITWARNING -- the percentage of maximum clients over which the GoServe main window bar chart will show a visible warning [0 through 100].
MENUBAR -- show menu bar on GoServe main window [ON/OFF].
RESPONSEGOAL -- sets the response time goal, in seconds. This affects the coloring of the response time graph, etc. [0 through 1.000].
RESPONSEGOALSHOW -- if set, the response time shown on the GoServe main window will be colored green if it is less than or equal to RESPONSEGOAL, yellow/orange if less than or equal to twice that, or red otherwise [ON/OFF].
SOUNDS -- audible indication of incoming connections [ON/OFF].
SOUNDALL -- sounds for all connections. If ON, give audible indication of all incoming connections; if OFF, only indicate when leaving the idle state. The SOUNDS setting must be ON for any sounds to be generated.
SURFACE -- surface GoServe main window on startup [ON/OFF].
TRACE -- copy audit lines to PMprint window [ON/OFF].
TEST -- enable test or experimental functions [ON/OFF].

[ previous section | GoServe | next section ]