54 lines
3.2 KiB
HTML
54 lines
3.2 KiB
HTML
<html>
|
|
<head>
|
|
<title> RuenBuffer Commands </title>
|
|
</head>
|
|
<body>
|
|
<h2>Rünbuffer Commands</h2>
|
|
<p>
|
|
LNS scientists have got used to using Rünbuffers for instrument
|
|
control. A Rünbuffer is an array of SICS commands which
|
|
typically represent a measurement. This Rünbuffer can be edited
|
|
at run time. This is very similar to a macro. In contrast to a macro
|
|
only SICS commands are allowed in Rünbuffers. When done with
|
|
editing the Rünbuffer it can be entered in a Rünlist. This
|
|
is a stack of Rünbuffers which get executed one by one. While
|
|
this is happening it is possible (from another client) to modify the
|
|
Rünlist and edit and add additional Rünbuffers on top of
|
|
the stack. This allows for almost infinite measurement and gives more
|
|
control than a static batch file. In order to cater for this scheme
|
|
three commands have been defined:</p>
|
|
<p>
|
|
The <b> Buf </b> object is responsible for creating and deleting Rünbuffers. The syntax is:<ul>
|
|
<li> <b> Buf new <i>name</i> </b> creates a new empty Rünbuffer with the name name. name will be installed as a SICS object afterwards.
|
|
<li> <b> Buf copy <i>name1 name2</i> </b> copies Rünbuffer name1 to buffer name2.
|
|
<li> <b> Buf del <i>name</i> </b> deletes the Rünbuffer name.
|
|
</ul>
|
|
</p>
|
|
<p>
|
|
After creation, the Rünbuffer is accessible by his name. It
|
|
then understands the commands:<ul>
|
|
<li> <b> <i>NAME</i> append <i>what shall we do with a drunken sailor</i> </b> will add all text after append as a new line at the end of the Rünbuffer.
|
|
<li> <b> <i>NAME</i> print </b> will list the contents of the Rünbuffer.
|
|
<li> <b> <i>NAME</i> del <i>iLine</i> </b> will delete line number iLine from the Rünbuffer.
|
|
<li> <b> <i>NAME</i> ins <i>iLine BimBamBim</i> </b> inserts a new line <b> after </b> line iLine into the Rünbuffer. The line will consist of everything given after the iLine.
|
|
<li> <b> <i>NAME</i> subst pattern <i>newval</i> </b> replaces all occurences of pattern in the Rünbuffer by the text specified as newval. Currently this feature allows only exact match but may be expanded to Unix style regexp or shell like globbing.
|
|
<li> <b> <i>NAME</i> save <i>filename</i> </b> saves the contents of the Rünbuffer into file filename.
|
|
<li> <b> <i>NAME</i> load <i>filename</i> </b> loads the Rünbuffer with the data in file filename.
|
|
<li> <b> <i>NAME</i> run </b> executes the Rünbuffer.
|
|
</ul>
|
|
</p>
|
|
<p>
|
|
The Rünlist is accessible as object <b> stack </b>. Only one Rünlist per server is permitted. The syntax:<ul>
|
|
<li> <b> stack add <i>NAME</i> </b> adds Rünbuffer name to the top of the stack.
|
|
<li> <b> stack list </b> lists the current Rünlist.
|
|
<li> <b> stack del <i>iLine</i> </b> deletes the Rünbuffer iLine from the Rünlist.
|
|
<li> <b> stack ins <i>iLine NAME</i> </b> inserts Rünbuffer name after Rünbuffer number iLine into the Rünlist.
|
|
<li> <b> stack run </b> executes the Rünlist and returns when all Rünbuffers are done.
|
|
<li> <b> stack batch </b> executes the Rünlist but does not return when done but waits for further Rünbuffers to be added to the list. This feature allows a sort of background process in the server.
|
|
</ul>
|
|
</p>
|
|
</body>
|
|
</html>
|
|
|
|
|