GoServe: The Options notebook

The Options notebook

If 'Options' is selected from the menu bar or pop-up menu, the Options notebook is opened. This has the following pages:

'Response' shows response time statistics, and lets you control the display and coloring of the statistics.
At the top of the page, a bar chart shows the distribution of the response times for recent requests, and (if there have been any requests) the average response time. This bar chart is redrawn automatically whenever the number of connections returns to idle, or you can refresh it manually by clicking on (selecting) the chart.
You can change the time-scale of this chart using the buttons at the bottom right of the box. Any measurements that would be "off-scale" (to the right of the chart) are included in the bar at the far right of the chart.
The lower part of the page lets you set a response time goal using a slider control; responses made within the specified time are displayed on the bar chart in green; responses made within twice that time are shown in an orangey-brown, and responses outside that limit are shown in a medium-dark red. The exact colors used will depend on your display.
The average response time shown on the page is colored according to the the same rules, as is the less precise average response time shown on the main window, if 'Color on main window' is checked.
See "Response time recording" for more details.
'General' lets you change certain aspects of the appearance of the main window, and control sounds made by the server.
Two 'Main Window' check-boxes are provided:
- 'Show menu bar' controls whether the menu bar is included in the display. To make menu selections when there is no menu bar, click anywhere on the GoServe window with the context menu button, in the usual Workplace Shell manner (this works even if the menu bar is visible).
- 'Surface on startup' lets you choose whether GoServe surfaces its window when started (if not minimized when shut down).
The 'Sounds on connections' checkbox requests that sounds be made (using the PC speaker) when a client browser connects to the server. Radio buttons let you choose whether to hear a note (on a ascending scale, depending on the number of connections) for every connection, or to hear a note only when the server moves from being idle to being busy (one or more connections).
The 'File command cache' controls are used for a performance optimization. See "File command cache" for details before using this option.
'Audit' lets you control the auditing of transactions (which events are to be audited, and whether timestamps in the file are in local time or GMT). See "The audit mechanism" for more details.
'Limits' (two pages) is used to control the operating limits of the server. See "The Limits options pages" for details.
'DataDir' lets you specify a new data directory name (path). This name is made available to the Rexx filter via the DataDir() function, and may be used by the filter to find the data to be served. (But note that the filter may ignore this information, if appropriate.)
GoServe will convert backslashes ('\') in the name to URI form (forward slashes, '/'), and will add a trailing '/' if one is not present. For example, entering 'd:\myhome' would result in the directory specification 'd:/myhome/' being passed to the filter via the DATADIR() function. This page checks that a drive is specified so it is not accidentally omitted.
'Filter' lets you specify a new filter name. This must be a simple filename and extension (the extension will default to the port number, if omitted).
The filter must be in the GoServe working (current) directory, so no drive or directory path should be specified. For example, if you enter 'myfilter.80', this would result in the filter 'd:\goserve\myfilter.80' being used, if 'd:\goserve' is the working directory. The filter must exist in the GoServe working directory in order for a new name to be accepted.

The Apply button

The 'Limits', 'DataDir', and 'Filter' pages let you choose when to apply the change or changes that you make, by clicking on the 'Apply' button (or pressing the Enter key). The Apply button is only enabled when you have made a change and all fields on the page are valid. If you leave a page (or close the notebook) when the Apply button is enabled, the changes will be applied automatically at that time.

[ previous section | GoServe | next section ]