6.4. Interactive Interface

In addition to the configuration file, commands can be sent directly to the driver at any time while it is running, by using the Cascade lsend utility or your own code. This feature might be used by an engineer or supervisor for debugging purposes. The syntax for run-time commands is the same as that used in the configuration file. It consists of the name of the command, followed by a space-separated list of arguments, all enclosed in parentheses, like this:

(command parameter1 parameter2 parameter3 ...)

To use lsend for sending commands to the driver, follow these steps:

  1. Go to a shell, and issue the nsnames command:
    [sh]$ nsnames
    Task         Queue       Domain       Node TaskID
    ...
    /dr/cif      /dr/cif     default      0    19544
    ...
    This gives you a list of named tasks currently registered with nserve. The driver should be listed by the global name you registered for it when you originally started it up. The default name is /dr/cif. You can use the -n option at startup to change the default name. Also see the description in attachNS for information on adding other names. This example uses the default name.
  2. Enter the following:
    [sh]$  lsend /dr/cif
    /dr/cif>
    If the command is successful the prompt changes to the name of the driver.
  3. Enter a command, using the Lisp syntax given above. For example:
    [sh]$  lsend /dr/cif
    /dr/cif> (write Speed 22.5)
    /dr/cif> OK
    /dr/cif>
    When the command executes, it returns a response, usually either OK on success or an error message.