Running Tdct


If you are looking at this from the tdct on-line help, you are already beyond this point.
If you peeked at the HTML files in the distribution, however, this section may be of interest to you.

Use your java installation to run the distributed tdct.jar file. Something like

java -jar tdct.jar

Running Tdct with Command Line Switches

Specify a non-default configuration file

-cfg <cfg file>

If this switch is specified, tdct uses the specified configuration file instead of the default.


Specify a dbd file on the command line

-dbd <dbd file>

If this switch is specified, tdct uses the specified dbd file, ignoring any [dbdpath] and [dbdfiles] directives in the cfg file.
Note: <dbd file> must include the path.


Starting tdct with a schematics name in order to bypass the File/Open dialog:

-i <schematic name>

If this switch is specified, Tdct starts in "graphics" mode and loads the given schematic from the specified directory. If only a file name (no path) is given and no -start command line switch is present, the current user directory is used.


Overriding the startup directory, which was given in the cfg file:

-start <path>

If this switch is specified, the startup directory (initial directory for the File/Open dialog) is set to path.

Specifying additional user paths:

-tup <paths>

If this switch is specified, the user paths specified with <paths> will precede the user paths specified in the configuration file when searching for user symbols..


Change the mouse button assignment for drawing the zoom rectangle:

-z <button>
This switch takes 1 or 2 as argument and allows assignment of which mouse buttons (1 = left, 2 = middle) will draw the zoom rectangle. The other button will draw the selection rectangle.


The following switches are for running tdct from the command line in "no graphics" mode. 
With these switches tdct  functions as a EPICS database builder only.


-s <schematic name>
If this switch is specified, Tdct runs without graphics and builds the schematic into an EPICS runtime database.

-st <schematic name>
If this switch is specified, Tdct runs without graphics and builds the schematic into an EPICS runtime database template.

-m <macro string>
This switch is only useful, if -s was specified. The macro string is parsed and the macro name-value-pairs specified are used in the database build process.

-db <data base directory>
This switch is overrides the database output directory specified in the configuration file.

-o <output file name>
This switch is only useful, if -s or -st were specified. The generated datahase the name <output file name>.


The following switches are for running tdct from the command line in "no graphics" mode.
With these switches tdct  functions as a converter for schematics from "Compatibility Mode" to "Dbd Mode".

-todbd <output directory>
-from <input_directory>
If these switches are specified, tdct converts schematics from Compatiblity Mode to Dbd Mode. The output directory must be different from the input directory.
If no -s switch is given, all schematics in the input directory are converted to Dbd Mode and saved to the ouput directory.

-s <schematic name>
If this switch is specified together with the -todbd switch and -from switch  tdct runs without graphics and converts the schematic to Dbd Mode.