54.1. Incorporating wienercamac in your scripts.

Incorporating wienercamac in your scripts is a two step process:

1. The NSCLDAQ Tcl package repository must be added to the Tcl interpreter's package search path.

2. The wienercamac package must be loaded into the interpreter via an explicit package require command.

There are two ways to manipulate the Tcl interpreter package load search path. The environment variable TCLLIBPATH is a space separated set of additionall directories to search for packages. The Tcl global variable auto_path is one of the several Tcl variables that control the package search path.

From now on we will assume that the environment variable DAQROOT has been defined to point to the top level of the NSCLDAQ installation directory tree. A bash shell script fragment that shows how to append the NSCLDAQ Tcl package repository to the TCLLIBPATH environment variable is shown below:

export TCLLIBPATH="$TCLLIBPATH $DAQROOT/TclLibs"
                

Similarly the code to add the NSCLDAQ Tcl package repository to to the auto_path interpreter global is shown below:

global env
global auto_path
lappend auto_path [file join $env(DAQROOT) TclLibs]

                    

Once the NSCLDAQ Tcl package repository has been added to the repository search path, an explicit package require as shown below must be issued prior to using the package commands:

package require wienercamac
                    

The commands defined by wienercamac are defined in the ::wienercamac:: namespace. The examples in the next section will use fully qualified command names (e.g. ::wienercamac::cdreg 1 1). It is also possible to import the commands from that namespace using the namespace import command. If you are also using the camac package this is not advisable as both packages share many of the same command names.