1.8.2. Custom Configuration Files

When the DataHub program starts up, you may wish to have certain points and data structures get created immediately. To do this, you can create one or more custom configuration files. These files must be listed in the bottom of the Scripting option of the Properties Window.

[Important]

Creating and editing custom configuration files should only be attempted by experienced users. If you do create a custom configuration file, we strongly recommend that it only be used for creating points and data structures, and not for standard configuration commands, such as those that are created and modified through entries in the Properties window. Doing otherwise could result in irregular behavior in the DataHub program.

The following sets of commands are the only ones that should be used in a custom configuration file:

General commands allowed in config files

create mult
set div
cset lock
write quality
cwrite secure
force append
cforce dump
add include

Model-related commands allowed in config files

alias private_attribute
assembly property
attribute subassembly
defaultprop type
instance

Only allowed in Windows config files

execute_plugin show_debug_messages
load_plugin show_event_log
unload_plugin show_icon
load_scripts show_properties
show_data show_script_log

Custom configuration files can be created using a text editor like Notepad, and are written in Lisp syntax. They should be put in the same directory as the Cogent DataHub executable, such as C:\Program Files (x86)\Cogent\Cogent DataHub\ (it may be different for your installation). Each entry of the file contains either a command or a comment. Comments are marked with a semicolon character (;) at the beginning of each line.

For more information about commands and their syntax, please refer to Cogent DataHub Command Set.

A small custom configuration file might look like this:

;;; Create some points in the default data domain and assign values.
(cset default:Point1 5)
(cset default:Point2 67.234)
(cset default:Point3 Hello)

;;; Create a new data domain
(create_domain NewDomain)

;;; Create some points in the new data domain and assign values.
(cset NewDomain:Point1 "A string")
(cset NewDomain:Point2 95)
(cset NewDomain:Point3 3.1519)