2.2. Configuration

The Cascade Historian is normally used with a configuration file called, for example, hi.cfg.

A configuration file is useful for sending initial start-up commands or specifying global defaults. These would include, for example:

historycreates a new history.
bufsizesets the history buffer size.
deadbandsets the history value deadband.
filebaseassociates the history with a file for data storage.
registerregisters histories with the Cascade DataHub.
unregisterunregisters histories with the Cascade DataHub.

The syntax for configuration commands is based on Lisp syntax. It consists of the name of the command, followed by a space-separated list of arguments, all enclosed in parentheses, like this:

(command arg1 arg2 arg3 ...)

These commands are commonly written one per line for clarity, but it is not necessary to do so. Any number of commands can be written on a line, each enclosed by parentheses. Also, if a command becomes very long, it is possible to break it up into several shorter lines with line breaks to make the configuration file more readable. In either case, the parentheses are what delimit the command.