Chapter 6. Setup

Cascade Connect can be configured in two ways: by using the Cascade Connect Setup window, or by editing the configuration file directly. This chapter is organized by the option grouping of the Setup window. Each section explains the options of one group, such as Program Launch Options, Decimal Translation, and so on.

6.1. Setup window and configuration file

You can open the Cascade Connect Setup window by clicking on the icon.

The Setup window looks like this:

Figure 6-1. Cascade Connect Setup window

Cascade Connect takes the information entered in the Setup window and writes it to the configuration file, whose name has the format: filename.ini. Every option in the Setup window corresponds to one line in the configuration file. The explanation for each Setup window option also includes the configuration file syntax for that option, with this format:

    optionname    entry

As an alternative to using the Setup window, you can edit the configuration file directly, using the Windows Notepad program or any word-processor. A typical group of entries in a configuration file looks like this:

    # Set up hosts and domains
    host            node9.acme.com
    default         default
    domain          default
    tcpservice      cascade

The options in the configuration file can be written in any order, but are typically grouped by functionality, as in the Setup window. Here we list them alphabetically:

Option	Refer to:
advise	Allow Advise in Program Launch Options
argument	Program Argument in Program Launch Options
autoexit	Auto Exit in Program Launch Options
autoreduce	DB Bandwidth Reduce in Program Launch Options
clientservice	Client DDE Service in DDE and Name Settings
clienttopic	Client DDE Topic in DDE and Name Settings
colonsub	Domain Separator in Domain Settings
debug	Debug Mode in Program Launch Options
decalways	All Occurrences in Decimal Translation
decfromqnx	Coming from Server in Decimal Translation
decnumbers	Numbers in Strings in Decimal Translation
dectoqnx	Going to Server in Decimal Translation
default	Default Domain in Domain Settings
domain	Cascade Domains in Domain Settings
host	Server IP Addresses in TCP/IP Settings
myservice	Cascade DDE Service in DDE and Name Settings
mytopic	Cascade DDE Topic in DDE and Name Settings
neverpoke	Never Poke in Program Launch Options
program	Program to Launch in Program Launch Options
qnxclient	Server client name in DDE and Name Settings
qnxname	Connect Server name in DDE and Name Settings
readonly	Read Only Mode in Program Launch Options
selectivepoke	Poke Only Non-Advise in Program Launch Options
tcpheartbeat	TCP Heartbeat in DDE and Name Settings
tcpservice	TCP Service in TCP/IP Settings
tcptimeout	TCP Timeout in DDE and Name Settings

Some option names include the string "qnx". This is because Cascade Connect originally supported the QNX Operating System data server environment exclusively. We retain the "qnx" strings in these names for backward compatibility.