linse/sics
0
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Initial revision

Browse Source
This commit is contained in:
cvs
2000-02-07 10:38:55 +00:00
commit fdc6b051c9
846 changed files with 230218 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

46
doc/user/config.htm Normal file
View File

@ -0,0 +1,46 @@
<html>
<head>
<title> Configuration Commands </title>
</head>
<body>
<h2>Configuration Commands</h2>
<p>
SICS allows to change the user rights of the current client server connection, control the amount of output a client receives and to specify additional logfiles where output will be placed. All this is accessed through the following commands:</p>
<p>
The SICS server logs all its activities to a logfile, regardless of what the user requested. This logfile is mainly intended to help in server debugging. However, clients may register an interest in certain server events and can have them displayed. This facility is accessed via the <b> GetLog </b> command. It needs to be stressed that this log receives messages from <b> all </b> active clients. GetLog understands the following messages:<ul>
<li> <b> GetLog All </b> achieves that all output to the server logfile is also written to the client which issued this command.
<li> <b> GetLog Kill </b> stops all logging output to the client.
<li> <b> GetLog OutCode </b> request that only certain events will be logged to the client issuing this command. Enables only the level specified. Multiple calls are possible.
</ul>
Possible values for OutCode in the last option are:<ul>
<li> <b> Internal </b> internal errors such as memory errors etc.
<li> <b> Command </b> all commands issued from any client to the server.
<li> <b> HWError </b> all errors generated by instrument hardware. The SICS server tries hard to fix HW errors in order to achieve stable operations and may not generate an error message if it was able to fix the problem. This option may be very helpful when tracking dodgy devices.
<li> <b> InError </b> All input errors found on any clients input.
<li> <b> Error </b> All error messages generated by all clients.
<li> <b> Status </b> some commands send status messages to the client invoking the command in order to monitor the state of a scan.
<li> <b> Value </b> Some commands return requested values to a user. These messages have an output code of Value.
</ul>
</p>
<p>
<b> config </b> allows to configure various aspects of the current client server connection. Basically three things can be manipulated: The connections output class, the user rights associated with it, and output files.</p>
<p>
<ul>
<li>The command <b> config OutCode val </b> sets the output code for the connection. By default all output is sent to the client. But a graphical user interface client might want to restrict message to only those delivering requested values and error messages and suppressing anything else. In order to achieve this, this command is provided. Possible values Values for val are Internal,Command, HWError,InError,Status, Error, Value. This list is hierarchical. For example specifying InError for val lets the client receive all messages tagged InError, Status, Error and Value, but not HWError, Command and Internal messages.
<li>Each connection between a client and the SICS server has user rights assocociated with it. These user rights can be configured at runtime with the command <b> config Rights Username Password </b>. If a matching entry can be found in the servers password database new rights will be set.
<li>Scientists are not content with having output on the screen. In order to
check results a log of all output may be required. The command <b> config
File name </b> makes all output to the client to be written to the file
specified by name as well. The file must be a file accessible to the server,
i.e. reside on the same machine as the server. Up to 10 logfiles can be
specified. Note, that a directly connected line printer is only a special
filename in unix.
<li><b> config close num</b> closes the log file denoted by num again.
<li><b>config list</b> lists the currently active values for outcode and user
rights.
</ul>
<p>
</body>
</html>